ReplyNodes

Agent Quickstart

Choose in this order:

  1. Start keyless. Call a keyless capability below right away; no account, key, or human is needed. Every response carries X-RateLimit-Remaining.
  2. Need more, or a keyed route? When a call returns 429 anonymous_limit_reached or 401, read error.next_action in the body: it names the exact call to make, the fields to send, and a human_message to show your human. In short: POST /api/agent/signup with the human's email returns a restricted key at once; ask for the 6-digit code from their email and POST /api/agent/verify with the same key to upgrade it. No browser is needed. The full protocol is https://replynodes.com/auth.md; the Authentication page summarizes it.
  3. Have a key? Use REST with REPLYNODES_API_KEY, or connect an MCP-capable client to https://mcp.replynodes.com/mcp and configure the key through the client's secret mechanism.

Keyless capabilities

Keyless capabilities: url-to-markdown (GET https://md.replynodes.com/<url>), brand-kit (GET https://brand.replynodes.com/<domain>), brand-logo, app-store-api, google-play-api, reddit-api, youtube-api, web-search, web-scraping, company-research and competitor-research.

Only these listed capabilities have keyless routes; each has a per-caller daily allowance (check X-RateLimit-Remaining). At the limit, the API returns 429 anonymous_limit_reached with error.next_action pointing at the key flow.

OptionUse it whenSource of truth
RESTYou control the HTTP call or tool functionOpenAPI + API Reference
SDKA verified generated package is available to your teamThe package docs and the OpenAPI contract
MCPYour client can connect to a remote Streamable HTTP serverMCP guide and generated MCP inventories
Agent SkillYour client reads instruction packagesThe package's SKILL.md, from replynodes-agent-skills

REST tool

Expose a function that performs a GET against the exact path from the OpenAPI document, adds an Authorization: Bearer ${REPLYNODES_API_KEY} header from a secret store, passes only declared parameters, and returns the JSON envelope. Do not let an agent turn a read operation into a write operation.

SDK path

There are no verified, installable SDK packages yet. Do not assume a package name or install command. Generate a client from /api/openapi.json if you need one, and keep Bearer authentication and the { data, meta } envelope.

Client choice

Claude Code, Cursor, Codex, VS Code, Hermes, and OpenCode can all use the REST pattern. MCP-capable clients can use MCP with native OAuth or a ReplyNodes API key. For skill-aware clients, install or reference the generated package that matches the provider; the package's SKILL.md and install instructions are authoritative. Do not copy stale endpoint lists into prompts.

On this page