MCP server

@centerfy/mcp exposes every endpoint as Model Context Protocol tools, so Claude, Cursor and other AI clients can work in your Centerfy account.

Every endpoint page names its MCP tool under the examples, and MCP tools lists all of them in one place. This page covers setup.

What it is

@centerfy/mcp is a stdio MCP server built on the Node SDK. It registers one tool per endpoint, named centerfy_<resource>_<action>, for example centerfy_contacts_create, centerfy_pipelines_list or centerfy_messages_send_ai. Agency endpoints are centerfy_agency_<resource>_<action>. Every tool has a typed input schema, so the AI client knows exactly which fields each operation accepts.

Configure

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "centerfy": {
      "command": "npx",
      "args": ["-y", "@centerfy/mcp"],
      "env": { "CENTERFY_API_KEY": "cfy_…" }
    }
  }
}

Claude Code

claude mcp add centerfy --env CENTERFY_API_KEY=cfy_… -- npx -y @centerfy/mcp

Cursor and other clients

Point the client at npx -y @centerfy/mcp (or the centerfy-mcp command after npm install -g @centerfy/mcp) with CENTERFY_API_KEY in its environment.

Environment variables

Variable	Required	Description
CENTERFY_API_KEY	Yes	Sub-account key. Enables the sub-account tools.
CENTERFY_AGENCY_API_KEY	No	Agency key. Adds the centerfy_agency_* tools.

Errors come back as tool errors (for example CenterfyNotFoundError (404): …), never as silent failures.