MCP / Agent Tooling

The Synapse MCP server exposes paid service discovery and invocation to MCP-compatible agent runtimes. It is a thin runtime bridge over Gateway, not a wallet, custody layer, provider manager, or pricing database.

Install

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

Required environment:

SYNAPSE_AGENT_KEY=agt_xxx

Optional environment:

SYNAPSE_ENV=staging
SYNAPSE_GATEWAY_URL=https://api-staging.synapse-network.ai
SYNAPSE_TIMEOUT_MS=30000

Tools

• discover_services: search callable services and read their current schemas, price models, and cost fields.
• invoke_and_pay: call a selected service with a bounded agent credential and the pricing observed during discovery.
• get_receipt: fetch settlement evidence for audit, retries, and reconciliation.

MCP pricing rules

• MCP server does not remember prices.
• Every paid task must call discover_services before invoke_and_pay.
• Fixed-price services must copy the current costUsdc returned by discovery.
• Token-metered services must use maxCostUsdc as the budget ceiling.
• If Gateway returns PRICE_MISMATCH, rediscover and retry with the fresh discovery response.
• Do not use docs example values as invoke prices.