MCP Quick Start

Use the hosted Remote MCP endpoint when your client supports Streamable HTTP. Use the local stdio package when your client expects a command.

Hosted Remote MCP

Remote endpoint:

https://mcp.synapse-network.ai/mcp

Unauthenticated requests should return 401. That is expected: the server is public at the network layer and protected by Synapse auth at the MCP layer.

curl -i https://mcp.synapse-network.ai/.well-known/oauth-protected-resource

curl -i -X POST https://mcp.synapse-network.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'

Local stdio MCP

npx -y @synapse-network-ai/mcp-server

Required environment:

SYNAPSE_AGENT_KEY=agt_xxx
SYNAPSE_ENV=prod
SYNAPSE_GATEWAY_URL=https://api.synapse-network.ai
SYNAPSE_TIMEOUT_MS=30000

Recommended first prompt

Ask your client to run a read-only discovery first:

Use the Synapse MCP server to discover one free or lowest-price weather API service.
Do not call invoke_and_pay.

Production caution

• staging is for sandbox/testnet workflows.
• prod uses real production balances.
• Do not share real agt_xxx keys, OAuth access tokens, OpenAI keys, private keys, or wallet mnemonics in prompts, screenshots, docs, or logs.