Skip to main content

​
Connect ContactShip with Claude Code

Connect your ContactShip account with Claude Code to manage agents, launch calls, and search contacts directly from the terminal.

​
Step by step

1

Open your terminal

Make sure you have Claude Code installed. If not, follow the instructions at claude.com/claude-code.
2

Add ContactShip

Run this command (replace YOUR_API_KEY with your actual key):
claude mcp add-json contactship '{"type":"sse","url":"https://mcp.contactship.ai/sse","headers":{"x-api-key":"YOUR_API_KEY"}}'
You must include "type":"sse" in the JSON. Without it, Claude Code will reject the configuration with “Invalid configuration”.
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

Verify the connection

claude mcp list
You should see contactship in the list.
4

Start using it

Open Claude Code and try:
claude
Inside, type /mcp to verify the server is connected. Then ask for what you need:
“Show all my ContactShip agents”

​
What you can ask

  • “List my agents” — See all your voice agents
  • “Show the config of agent ag_xxx” — Full detail of an agent
  • “Rewrite the survey agent’s prompt to sound more natural” — Reads, rewrites, and updates
  • “Call +54 9 341 555 1234 with the collections agent” — Launches a call
  • “Search contacts with last name Pérez” — Searches the CRM
  • “Show my phone numbers” — Lists available numbers

​
Disconnect

If you need to remove the connection: 
claude mcp remove contactship

​
Troubleshooting

Make sure to include "type":"sse" in the JSON. The correct command is:
claude mcp add-json contactship '{"type":"sse","url":"https://mcp.contactship.ai/sse","headers":{"x-api-key":"YOUR_KEY"}}'
Check that the server is up:
curl https://mcp.contactship.ai/health
If it returns {"status":"ok"}, the server is fine. The issue may be your DNS. Try:
sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
Test your API key directly:
curl -H 'x-api-key: YOUR_KEY' https://api.contactship.ai/v1/agents
If it returns a 401 error, your key is invalid. Generate a new one from the dashboard.