Agent Quickstart
Choose in this order:
- Start keyless. Call a keyless capability below right away; no account,
key, or human is needed. Every response carries
X-RateLimit-Remaining. - Need more, or a keyed route? When a call returns
429 anonymous_limit_reachedor401, readerror.next_actionin the body: it names the exact call to make, the fields to send, and ahuman_messageto show your human. In short:POST /api/agent/signupwith the human's email returns a restricted key at once; ask for the 6-digit code from their email andPOST /api/agent/verifywith the same key to upgrade it. No browser is needed. The full protocol is https://replynodes.com/auth.md; the Authentication page summarizes it. - Have a key? Use REST with
REPLYNODES_API_KEY, or connect an MCP-capable client tohttps://mcp.replynodes.com/mcpand 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.
| Option | Use it when | Source of truth |
|---|---|---|
| REST | You control the HTTP call or tool function | OpenAPI + API Reference |
| SDK | A verified generated package is available to your team | The package docs and the OpenAPI contract |
| MCP | Your client can connect to a remote Streamable HTTP server | MCP guide and generated MCP inventories |
| Agent Skill | Your client reads instruction packages | The 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.