Connect a client

The QuantConomy MCP server is hosted — there is nothing to install. Point any MCP-capable client at the endpoint and authenticate with your API key:

https://mcp.quantconomy.com/mcp

The transport is Streamable HTTP (stateless). The server reads your key from the Authorization: Bearer mtk_... header on every request, so each call your agent makes is authenticated and metered exactly like a direct REST call.

You need an API key first. Create one in the dashboard at app.quantconomy.com under Account → API Keys. Keys look like mtk_a1b2c3d4.... See Authentication for details.

Caution

Treat your API key like a password. The server authenticates per request from the Authorization header, so anyone who can read your client config can call the API as you. Use a dedicated key for each client and revoke it if it leaks.

Connect your client

Claude Code

Add the server over HTTP with your key as an Authorization header:

1. Add the server:

   claude mcp add --transport http quantconomy https://mcp.quantconomy.com/mcp \
     --header "Authorization: Bearer mtk_your_key_here"

2. Confirm it registered and is reachable:

   claude mcp list

Claude Desktop

Claude Desktop connects to remote servers as a custom connector.

1. Open Settings → Connectors → Add custom connector.
2. Set the URL to https://mcp.quantconomy.com/mcp.
3. Under authentication, add the header Authorization with the value Bearer mtk_your_key_here.
4. Save, then enable the connector in a chat. The QuantConomy tools, resources, and prompts appear in the tool picker.

Cursor

Cursor reads MCP servers from mcp.json (~/.cursor/mcp.json for all projects, or .cursor/mcp.json inside a project).

1. Add the server:

   {
     "mcpServers": {
       "quantconomy": {
         "url": "https://mcp.quantconomy.com/mcp",
         "headers": {
           "Authorization": "Bearer mtk_your_key_here"
         }
       }
     }
   }

2. Open Cursor → Settings → MCP and confirm the quantconomy server shows as connected with its tools enabled.

ChatGPT / other

Any client that supports adding a remote MCP server by URL connects the same way.

1. Add a new MCP server with the URL https://mcp.quantconomy.com/mcp.

2. Choose Streamable HTTP (not SSE) if asked for a transport.

3. Set authentication to a Bearer token and use your API key:

   Authorization: Bearer mtk_your_key_here

4. Save and connect. The client lists the QuantConomy tools, resources, and prompts.

Note

Health check: GET https://mcp.quantconomy.com/health returns {"status":"ok"} if the server is reachable.

Verify the connection

Once connected, ask the agent to call get_account (or read the quantconomy://account resource). It returns your plan, credit balance, and rate limits — a quick confirmation that your key is wired up correctly. If you get a 401, the key is missing or invalid; a 402 means you are out of credits.

Next steps

Tools & resources Every tool, resource, and prompt the server exposes, with arguments.