ConnectMachine's MCP server

What the server exposes

The server publishes 40 focused tools. Your assistant picks the right one for each request; you never call tools by name.

• Contacts (12 tools) - list, get, find, create, update, delete, smart search, industries, counts, duplicates, merge, and network assignment.
• Events (3 tools) - list your events and attach or detach the event where you met a contact.
• Networks (5 tools) - list, create, update, delete, and reorder your networks.
• Digital cards (7 tools) - list, get, create, update, delete, read a shared card, and extract contact data from a card photo.
• Import and export (6 tools) - batch import sessions, progress tracking, and CSV export.
• Notifications and profile (7 tools) - notifications, unread counts, profile, and subscription status.

Get your MCP key

Your key is a personal bearer token tied to your ConnectMachine account. Open the MCP connect page and sign in with your account email (one-time code) or Google. The page shows your key plus ready-made config snippets for popular tools. Keep the key secret and generate a new one to revoke the old.

• Connect page: licenses.connectmachine.ai/mcp/auth
• Every request your AI tool makes is authenticated with this key against your account only.

Connect Claude

Claude supports remote MCP servers in the web app, desktop app, and Claude Code.

• Claude web and desktop: Settings > Connectors > Add custom connector, then paste https://mcp.connectmachine.ai/mcp.
• Claude Code (terminal): claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp --header "Authorization: Bearer YOUR_MCP_KEY".
• JSON config clients: add the server under mcpServers with the url and an Authorization: Bearer header.

Connect Cursor

Create or edit .cursor/mcp.json in your project (or the global ~/.cursor/mcp.json) and add the connectmachine entry under mcpServers with the server url and an Authorization: Bearer header carrying your key. Reload Cursor and the ConnectMachine tools appear in the MCP list.

Connect VS Code

VS Code uses a servers object instead of mcpServers. Create .vscode/mcp.json in your workspace with an entry of type "http", the server url, and the Authorization header. The connect page generates this exact file for you.

Other MCP clients

Any client that supports remote HTTP MCP servers can connect with two values: the server URL and your key sent as a bearer token in the Authorization header. Clients that implement the MCP OAuth flow can also sign in through the browser; the server supports OAuth 2.0 with dynamic client registration and PKCE.

• Server URL: https://mcp.connectmachine.ai/mcp
• Auth header: Authorization: Bearer YOUR_MCP_KEY

How the tools behave

The server is designed so an assistant cannot quietly do the wrong thing with your network.

• Same-name safety: when two contacts share a name, find_contact reports the ambiguity and instructs the assistant to ask you which one you mean instead of guessing.
• Events, not tags: organizing follows the app. You attach the event where you met someone; free-form tagging is not exposed.
• Smart search covers name, company, job title, email, phone, notes, location, meeting location, and event names.
• New accounts: until you finish onboarding in the app, tools reply with guidance and app download links instead of empty results.

Plans and Premium actions

Connecting an AI tool is included with ConnectMachine. Actions that are Premium in the app stay Premium over MCP, such as CSV export and filtering by industry or location. When a free account hits one of these, the tool returns a clear message naming the feature and how to upgrade, never a silent failure.

Privacy and security

The MCP server is a thin, authenticated bridge to the ConnectMachine API. It stores no copy of your network.

• Your key is validated against your account on every request; there is no cross-account access.
• The assistant receives only the data needed to answer the specific request.
• Revoke access anytime: generate a new key or delete the config from your tool.
• Terms and privacy: connectmachine.ai/en/legal/terms-of-service and connectmachine.ai/en/legal/privacy.

Troubleshooting

Most connection problems come down to the URL, the key, or account state.

• Invalid or expired key: sign in on the connect page again and use the fresh key.
• Onboarding message: finish onboarding in the ConnectMachine app, then ask again.
• Premium message: the action needs an upgraded plan; everything else keeps working.
• Connection fails: confirm the URL is exactly https://mcp.connectmachine.ai/mcp and restart your AI tool after config changes.