Cavyro MCP server

Cavyro MCP server

Cavyro is a Telegram-native CRM for agents and small sales teams: contacts, companies, deals, pipelines, campaigns, docs and reports. This repository describes Cavyro's hosted Model Context Protocol server, listed in the MCP Registry as com.cavyro/cavyro.

The server is hosted, so there is nothing to install or run. Point your MCP client at it and it reads and acts on your Cavyro workspace with your permissions.

• Endpoint: https://ai.cavyro.com/mcp (Streamable HTTP)
• Server card: https://ai.cavyro.com/.well-known/mcp/server-card.json (full tool surface with input schemas, no credentials needed)
• Website: cavyro.com · Help: help.cavyro.com/ai/mcp

The server source is not published here. The tool surface is generated from the running server and exposed in the server card above, so the card is always the authoritative description of what the server does.

What it does

The server exposes a fixed set of nine generic tools over a resource and action registry, instead of one tool per API operation. The client discovers resources and actions on demand, so the tool list stays small while covering around 90 CRM operations.

Covered domains: deals, contacts, companies, pipelines and stages, comments and reactions, activity feed, notifications, workspaces, members, teams, groups, invitations, custom field definitions, automations, docs with their pages, reports, and read-only Telegram chats.

All tool responses share one envelope, { "data": ..., "pagination": ... }, with pagination present only on paginated list results.

The connection acts as you. An external AI can only see and do what your Cavyro role allows in that workspace.

Authentication

Every request needs two headers:

Create an API token in Cavyro under Settings → API tokens. Tokens can expire after 7, 30 or 90 days, or never for integrations that cannot rotate them. Revoking a token cuts the client off immediately.

There is no OAuth flow. The server answers unauthenticated requests with 401 and a WWW-Authenticate: Bearer realm="cavyro" challenge. MCP is a Pro feature; MCP calls do not consume Cavyro AI credits, the model tokens are paid by your own client subscription.

Configuration

Replace and in the snippets below. Cavyro's settings page generates the same snippet with your workspace ID filled in.

VS Code (GitHub Copilot)

.vscode/mcp.json, or MCP: Add Server from the command palette:

Shortened. The full README is on GitHub.