Skip to main content
AgentSIM’s MCP server uses HTTP transport (streamable-HTTP), not SSE. Always connect with type: "http" or --transport http. The /sse endpoint does not exist.

​
Claude Desktop

Open ~/.claude/config.json (create it if it doesn’t exist) and add: 
{
  "mcpServers": {
    "agentsim": {
      "type": "http",
      "url": "https://mcp.agentsim.dev/mcp",
      "env": {
        "AGENTSIM_API_KEY": "asm_live_..."
      }
    }
  }
}
Replace asm_live_... with your API key from console.agentsim.dev. Restart Claude Desktop after saving.

​
Claude Code

claude mcp add --transport http agentsim https://mcp.agentsim.dev/mcp
claude mcp set-env agentsim AGENTSIM_API_KEY=asm_live_...

​
Cursor

Add to .cursor/mcp.json in your project root (or the global Cursor MCP config): 
{
  "mcpServers": {
    "agentsim": {
      "type": "http",
      "url": "https://mcp.agentsim.dev/mcp",
      "env": {
        "AGENTSIM_API_KEY": "asm_live_..."
      }
    }
  }
}
Reload the Cursor window after saving (Cmd+Shift+P → “Reload Window”).

​
Other MCP clients

Any MCP-compatible client that supports HTTP transport can connect using the same configuration shape: 
{
  "mcpServers": {
    "agentsim": {
      "type": "http",
      "url": "https://mcp.agentsim.dev/mcp",
      "env": {
        "AGENTSIM_API_KEY": "asm_live_..."
      }
    }
  }
}
If your client uses a different config format, the two required values are:
  • Transport: HTTP (streamable-HTTP)
  • URL: https://mcp.agentsim.dev/mcp

​
Verify your connection

Once connected, open a new chat and ask:
“List my active AgentSIM sessions.”
The assistant should call list_numbers and respond with either a list of active sessions or confirm that there are none. If it says it doesn’t have an AgentSIM tool, your MCP configuration isn’t loaded — check the config file path and restart your client.