Skip to main content

​
Connect ContactShip with Cursor

Connect your ContactShip account with Cursor to manage voice agents, launch calls, and search contacts without leaving your editor.

​
Step by step

1

Open your project in Cursor

Open any project in Cursor IDE.
2

Create the config file

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for all projects):
{
  "mcpServers": {
    "contactship": {
      "url": "https://mcp.contactship.ai/sse",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
Replace YOUR_API_KEY with your actual key.
Don’t have your API key? Generate it at app.contactship.ai/es/organization/api-keys. Requires a Starter subscription ($30 USD/month) or above.
3

Done — auto-connects

Cursor detects the file and connects automatically. No restart needed.Try opening the Cursor chat (Cmd+L / Ctrl+L) and typing:
“Show all my ContactShip agents”

​
What you can ask Cursor

  • “Show my agents” — Lists all your voice agents
  • “Show the sales agent config” — Full detail
  • “Update the prompt to be more professional” — Reads, rewrites, and saves
  • “Call +54 9 11 5555 1234 with my agent” — Launches the call
  • “Find the contact with phone +52 55 1234 5678” — Searches the CRM

​
Global vs. project config

FileScope
.cursor/mcp.json (in your project)Only that project
~/.cursor/mcp.json (in your home)All your projects
If you have the file in both places, the project config takes priority.

​
Troubleshooting

Check that the file is named exactly .cursor/mcp.json and is in the project root. The JSON must be valid (no trailing commas).
Check the server is up by opening in your browser: https://mcp.contactship.ai/healthIt should return {"status":"ok"}.
Close and reopen Cursor. Tools are loaded at startup.