[ CONNECT DOCS ]

Connect an agent in five minutes.

Every platform you publish gets a real MCP server — Streamable HTTP, JSON-RPC 2.0 — at https://thinknorth.consulting/mcp/s/<slug>/, keyed with Authorization: Bearer <key>.

The 5-minute path

Create a platform in the console — name, description, base URL of your real API.
Import your API spec — the OpenAPI (a.k.a. Swagger) JSON file that describes your API's endpoints; most frameworks generate one at /openapi.json. (OpenAPI is a file-format standard — no relation to OpenAI.) Paths become endpoints, tags become groups. Or add endpoints by hand.
Add a tier granting the groups you want to expose, with rate limits, included volume, and pricing.
Mint a key on that tier.
Connect — use the snippets below with your slug and key.

Claude Code

terminal

claude mcp add --transport http mytools https://thinknorth.consulting/mcp/s/<slug>/ \ --header "Authorization: Bearer <key>"

Then /mcp inside Claude Code shows the server and its tools.

claude.ai (custom connector)

Settings → Connectors → Add custom connector:

Remote MCP server URL	https://thinknorth.consulting/mcp/s/<slug>/
HTTP header	Authorization: Bearer <key>

Raw JSON-RPC (curl)

Initialize the session:

initialize

curl -s https://thinknorth.consulting/mcp/s/<slug>/ \ -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{ "protocolVersion":"2025-03-26", "capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}'

List the tools your key's tier grants:

tools/list

curl -s https://thinknorth.consulting/mcp/s/<slug>/ \ -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Call one (tool names are <group>__<endpoint>; path params, query and body all go in arguments):

tools/call

curl -s https://thinknorth.consulting/mcp/s/<slug>/ \ -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{ "name":"refunds__create_refund", "arguments":{"charge_id":"ch_123","amount":500}}}'

Discovery & metering

Agent manifest (“yellow pages”, no key needed): https://thinknorth.consulting/mcp/m/<slug>.json
Legacy HTTP proxy for non-MCP consumers: https://thinknorth.consulting/mcp/api/<slug>/<endpoint path> with the same Bearer key.
Every call is metered per key. Rate limits: tier-level per minute, with optional per-group ceilings. Over the cap → JSON-RPC error -32000 volume_cap_reached; over the rate → -32000 rate_limited.
Usage and estimated billing live in the console under each platform's Usage tab.