Quickstart

You need an MCP server reachable over HTTPS. No code changes are required.

1. Create the gateway

In the dashboard, open the Gateway tab (under the Spanly group in the sidebar) for the environment you want. Enter your MCP server URL, for example https://mcp.your-company.com/mcp, and select Create gateway.

You get a dedicated endpoint immediately:

https://your-project.gateway.us.spanly.com/mcp

(eu instead of us for EU environments.)

2. Test the connection

Select Test connection. Spanly runs a minimal MCP handshake from the same network path real traffic takes and reports the server name, version, tool count, and duration. If it fails, the error names the stage (DNS, connect, TLS, HTTP, initialize, or tools list) so you know exactly what to fix.

3. Point a client at the endpoint

Configure any MCP client with the gateway URL. For example, with the TypeScript SDK client:

const transport = new StreamableHTTPClientTransport(
  new URL('https://your-project.gateway.us.spanly.com/mcp'),
);
await client.connect(transport);

4. See requests in the dashboard

Make a few tool calls, then open the Requests tab. Each request shows the method, tool, duration, and status. Requests that went through the gateway also show the gateway overhead added versus your upstream's own time.

That is the whole loop. Everything else on the Gateway tab (custom domains, edge protection, client keys, capture modes) is optional.