Cavyro for developers and agents

The Cavyro API,
documented for machines.

One REST API at api.cavyro.com, one OpenAPI document, one hosted MCP server. Everything a client or an agent needs to run a Cavyro workspace without a browser.

Read the API reference Get the OpenAPI spec

Everything, at a fixed address

Developer resources

Each of these lives at a stable URL. Bookmark them, or let your agent crawl them.

API reference

developers.cavyro.com

Every endpoint with request and response shapes, rendered from the spec below.

OpenAPI spec (JSON)

cavyro.com/openapi.json

OpenAPI 3.2 description of the whole public API. Point your generator or your agent at it.

OpenAPI spec (YAML)

cavyro.com/openapi.yaml

The same document in YAML, byte-identical to the one the reference renders.

MCP server

ai.cavyro.com/mcp

Streamable HTTP MCP endpoint. Over 120 CRM actions as typed tools, plus discovery tools so an agent finds the right one.

Site overview for agents

cavyro.com/llms.txt

What Cavyro is, what every page covers, and where the developer resources live.

Help center

help.cavyro.com

Product guides, including API token creation and MCP client setup.

Authentication

The API is not open

Every endpoint needs a token. There is no anonymous read tier, and no public sandbox data.

list deals

curl https://api.cavyro.com/api/v1/deals \
  -H "Authorization: Bearer <your-api-token>" \
  -H "X-Workspace-Id: <workspace-id>"

Bearer tokens. Create one in the app under Settings, API Tokens. It carries your permissions in that workspace and can be revoked at any time.
Workspace header. Workspace-scoped endpoints also take X-Workspace-Id, so one token can act in more than one workspace.
Same token for MCP. The hosted MCP server accepts the same credentials, with the same permissions.
No OAuth yet. There is no authorization server and no third-party app flow. If you need one, tell us what you're building at support@cavyro.com.

Model Context Protocol

Point an agent at the whole CRM

Add the hosted MCP server to Claude, Cursor or any MCP client. The agent gets over 120 typed actions, scoped to your workspace.

Claude
ChatGPT
Gemini
Cursor

Any other MCP client works the same way.

mcp.json

{
  "mcpServers": {
    "cavyro": {
      "url": "https://ai.cavyro.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-Workspace-Id": "<workspace-id>"
      }
    }
  }
}

The MCP server is on the Pro plan. See Agentic CRM for what the tools cover.

If your client installs from a registry, Cavyro is listed on Smithery and in the official MCP Registry as com.cavyro/cavyro.

Webhooks

Get told, don't poll

Subscribe to deal, contact and company events and Cavyro posts them to your endpoint, signed so you can verify they came from us.

Manage subscriptions through POST /api/v1/webhook_subscriptions. Payload shapes, headers and the signature scheme are in the API reference under Webhooks. Webhooks are included on every plan.

For crawlers and agents

This site answers markdown

Ask any page for markdown and you get markdown, from the same URL.

curl -H "Accept: text/markdown" https://cavyro.com/pricing/

/llms.txt lists every page with a one-line summary.
/sitemap-index.xml is the full map, with honest lastmod dates.
/openapi.json is the API surface, machine-readable.
Unknown paths return a real 404 with links back, in HTML or markdown.

Build on it free for 5 days

The trial is the full plan, MCP server included. Create a workspace, mint a token, start calling.

Start free Read the docs

The Cavyro API, documented for machines.