MCP

The gateway exposes a stateless Streamable HTTP MCP transport at:

https://api.replynodes.com/mcp

The gateway registers POST and GET for this route when an MCP handler is attached. It accepts the MCP transport's JSON-RPC calls. Bearer credentials are validated when supplied; a request without Authorization is allowed to reach the gateway's accountless payment path. In package mode the route is not attached. The gateway code is the authority for transport and payment details.

Connect

Configure your MCP client with the remote server URL and store the ReplyNodes key as a secret. The exact UI or config file varies by client; Claude Code, Cursor, Codex, VS Code, and other MCP clients should all be configured with the equivalent of:

{
  "url": "https://api.replynodes.com/mcp",
  "headers": {
    "Authorization": "Bearer ${FETCHER_API_KEY}"
  }
}

The placeholder is illustrative configuration syntax: use the secret mechanism documented by your client, and never paste a real key into a committed file.

Verify

Use the client's MCP initialize/discovery flow, then inspect the tool list. Tools are derived from provider operation manifests and map back to read-only gateway GETs. Tool arguments become path or query parameters; unknown tools and malformed arguments fail with an error response.

Tool categories follow the actual provider tags: web context/search, Hacker News, Reddit, TikTok, Instagram, YouTube, app stores, maps, shopping, and FOMO where enabled by the running gateway. Availability can vary by deployment; the OpenAPI contract and gateway capability responses are the authority.

Troubleshooting

• 401: if using prepaid access, check that the client sends an Authorization Bearer header on the MCP request; missing auth may instead require the configured accountless payment flow.
• 404: confirm the gateway is not running in package mode and that the URL ends in /mcp.
• 400: validate JSON-RPC, MCP protocol version, tool name, and declared arguments.
• 429: honor Retry-After and reduce concurrency.
• Need a provider-specific skill? Use the generated package under services/social-data-skills/generated/; do not infer tool names from this page.