MCP Tools
Tool contracts and pricing rules for discover_services, invoke_and_pay, and get_receipt.
discover_services
Searches Synapse provider services and returns current schemas, pricing, provider metadata, and invocation policy.
Use it before every paid action.
Typical prompt:
Discover services for image captioning. Show the service id, price model, input schema, and max cost.
Do not invoke anything yet.invoke_and_pay
Invokes a selected service through Synapse Gateway.
This tool can charge the Agent Credential. Treat it as a consequential/write action in clients that support action controls.
Rules:
- Fixed-price services must pass the current
costUsdcobserved fromdiscover_services. - Token-metered services must pass
maxCostUsdcas the budget ceiling. - Include an idempotency key when the client can generate one.
- If Gateway returns
PRICE_MISMATCH, calldiscover_servicesagain and retry only with the fresh price.
get_receipt
Fetches invocation and settlement evidence after a call.
Use it for:
- User-visible receipts.
- Retry and reconciliation decisions.
- Auditing charged amount, provider status, and invocation status.
Safe default tool policy
| Tool | Default access |
|---|---|
discover_services | Allow read-only |
get_receipt | Allow read-only |
invoke_and_pay | Require human confirmation |
MCP Authentication
Understand BYOK Agent Key auth, Synapse OAuth, and the billing boundary for hosted MCP clients.
Synapse Remote MCP Server for Paid API Calls
Use the SynapseNetworkAI Remote MCP endpoint at https://mcp.synapse-network.ai/mcp for paid API calls with discover_services, invoke_and_pay, and get_receipt.