Carragent for developers

Carragent runs AI agents for small businesses. These endpoints give AI agents and developers the same facts the site shows: what each agent does, the plans and prices, and a search over both. They are public and read-only, need no key and touch no customer data.

Use them when a user asks what Carragent does, which agent fits a task, or what it costs. Signing up and connecting tools happen on the site, by the business owner.

curl https://carragent.com/api/v1/plans
curl "https://carragent.com/api/v1/agents?lang=es&limit=5"
curl "https://carragent.com/api/v1/search?q=late%20invoices"

• GET /api/v1/agents: every agent, cursor-paginated (limit, cursor, lang).
• GET /api/v1/agents/{id}: one agent.
• GET /api/v1/plans: plans, prices in USD cents, trial and refund terms.
• GET /api/v1/search?q=: keyword search over agents and plans.

Spec: /openapi.json (OpenAPI 3.1). API catalog: /.well-known/api-catalog.

https://carragent.com/api/mcp, Streamable HTTP, no auth. Server card: /.well-known/mcp/server-card.json.

• list_agents: List every Carragent AI agent: what it does, when it runs, what waits for the owner's approval, what it never does and which tools (Stripe, Google Calendar, HubSpot…) it connects to. Use to answer 'what can Carragent do?'.
• get_agent: Get one agent by id (for example collections, scheduling, leads, reviews, report). Use after list_agents or search_carragent to give the details of one agent.
• list_plans: List the plans with monthly and yearly prices in USD cents (plus applicable taxes), their limits, the free-trial length and the refund terms. Use to answer 'how much does Carragent cost?'.
• search_carragent: Keyword search over Carragent's agents and plans, best match first. Use to find the agent for a task, such as 'chase late invoices' or 'confirm appointments'.

The official CLI, carragent on npm, reads the same API from a terminal. It needs Node 20 or later and no key. Add --json for the API's JSON and --lang es or fr for another language.

npx carragent agents
npx carragent agent collections
npx carragent plans --lang es
npx carragent search "late invoices"

For an MCP client that launches a command, npx -y carragent mcp relays the MCP server above over stdio.

• /llms.txt: the summary.
• /.well-known/agent-skills/index.json: the Carragent skill.
• /.well-known/ard.json (also /.well-known/ai-catalog.json): the resource catalog. Its trust manifests are signed with the key in /.well-known/did.json (did:web).
• /ask: NLWeb natural-language search (GET /ask?query=, or POST with Accept: text/event-stream to stream).
• /auth.md: authentication (optional OAuth 2.0).

No token is needed. With one, the limit rises to 300 requests a minute per client. Register a client at POST /api/oauth2/register, then use the client-credentials grant at POST /api/oauth2/token and send Authorization: Bearer. Tokens last an hour.

Registration takes an Idempotency-Key header, such as a UUID: a retry with the same key returns the same client and secret instead of a second client.

• agents:read: Read the agents (/api/v1/agents).
• plans:read: Read the plans and prices (/api/v1/plans).
• search:read: Search the agents and plans (/api/v1/search).

Metadata: /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource.

60 requests every 60 seconds per IP without a token, 300 per OAuth client with one. Every response carries the RateLimit and RateLimit-Policy headers; a 429 carries Retry-After.

Errors are RFC 9457 problem details (application/problem+json) with a stable code, such as invalid_parameter, agent_not_found or rate_limited.

Current version: 1.0.0, in the Carragent-Api-Version header. The major version is in the path. Additive changes keep v1; a breaking change ships as /api/v2, and v1 then sends Deprecation and a Sunset date at least 90 days ahead.

Questions: admin@carragent.com.