Hosted endpoints

Free token

curl -s -X POST https://mcp.zovo.one/mcp/token

URL forms

• path

  https://mcp.zovo.one/mcp/<server>/t/<token>

  Copy

  Clients that accept only a URL (Claude.ai, Cursor, VS Code, Windsurf).

• header

  https://mcp.zovo.one/mcp/<server>
  Authorization: Bearer <token>

  Copy

  Clients that can set headers (Claude Code, SDKs, curl). The header wins over a token in the URL.

• query

  https://mcp.zovo.one/mcp/<server>?token=<token>

  Copy

  Clients that take a query string but no header.

• bare

  https://mcp.zovo.one/mcp/<server>

  Copy

  Answers initialize and tools/list. Refuses every tools/call with 401. Not a working install.

A full session with curl

1. 1. initialize

   curl -s -X POST https://mcp.zovo.one/mcp/currency/t/<token> -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0.0.1"}}}'

   Copy

2. 2. tools/list

   curl -s -X POST https://mcp.zovo.one/mcp/currency/t/<token> -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

   Copy

   result.tools has 10 tools: rates_latest, convert, convert_many, fx_rates_for, rate_history, rate_on, currencies_list, cache_status, license_status, license_activate. Each has name, title, description, inputSchema.

3. 3. tools/call

   curl -s -X POST https://mcp.zovo.one/mcp/currency/t/<token> -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"convert","arguments":{"amount":100,"from":"EUR","to":"USD"}}}'

   Copy

   result.content[0].text is a JSON string: amount, from, to, rate 1.113, rate_date 2026-10-29, result "USD 111.30", source European Central Bank. result.content[1].text is a free-tier line: 600 calls/hour, 30-day retention, Pro link.