Hosted MCP quickstart

Connect your agent to hosted MCP when you want noxstock tools without running a local server.

• Endpoint: https://api.noxstock.com/mcp
• Auth header: X-API-Key: $NOXSTOCK_API_KEY
• Mode: read-only
• Source of truth: REST and OpenAPI

MCP tools call the same REST routes. Successful tool calls return the REST { "data": ... } envelope unchanged; depending on the client, it may appear as text JSON and/or structured content.

REST errors remain the source of truth:

{
  "error": {
    "code": "PLAN_UPGRADE_REQUIRED",
    "message": "This endpoint requires Starter or Builder. Free includes search, coverage, snapshot, and valuation.",
    "retryable": false
  }
}

MCP clients may display the same failure as a tool error string:

[PLAN_UPGRADE_REQUIRED] This endpoint requires Starter or Builder. Free includes search, coverage, snapshot, and valuation. (retryable: false)

1. Export your key

export NOXSTOCK_API_KEY="<your_noxstock_api_key>"

2. Add hosted MCP in Claude Code

claude mcp add --transport http noxstock https://api.noxstock.com/mcp \
  --header "X-API-Key: $NOXSTOCK_API_KEY"

3. Or use generic MCP JSON

Use this shape for clients that accept JSON MCP config.

{
  "mcpServers": {
    "noxstock": {
      "url": "https://api.noxstock.com/mcp",
      "headers": {
        "X-API-Key": "$NOXSTOCK_API_KEY"
      }
    }
  }
}

4. Smoke test

After connecting, confirm the noxstock_* tools loaded. At minimum, you should see:

• noxstock_search
• noxstock_coverage
• noxstock_snapshot
• noxstock_valuation

Then call:

{
  "tool": "noxstock_snapshot",
  "arguments": {
    "symbol": "AAPL"
  }
}

A successful response should include { "data": ... }, freshness, and as_of:

{
  "data": {
    "symbol": "AAPL",
    "freshness": "intraday",
    "as_of": "2026-06-02T18:32:10Z",
    "quote": {
      "price": 195.64
    }
  }
}

If the client reports [UNAUTHORIZED], check the X-API-Key header and make sure $NOXSTOCK_API_KEY is set in the environment the MCP client actually uses.

Access rules

MCP uses the same plan access as REST.

A Free key that calls a paid tool should get PLAN_UPGRADE_REQUIRED. Treat that as an access issue, not an outage.

What MCP does not do

MCP is read-only. It does not trade, execute orders, call providers directly, calculate extra fields, or reshape schemas.

Use REST/OpenAPI when you need exact contracts, generated schemas, retries, HTTP status handling, or a server integration. MCP is the fast path for agents; REST remains the source of truth.

Next