​
MCP Server

The SynapseX MCP Gateway exposes platform tools through two current surfaces:
SurfacePathUse it for
REST tool catalog/v1/mcp/toolsListing and executing API Gateway catalog tools
MCP JSON-RPC toolkit/mcp/mcp/ in the current in-repo bridge mountMCP-compatible tool listing and calls routed to VM agents

​
What is MCP?

Model Context Protocol (MCP) is an open protocol that allows language models (LLMs) to interact with external tools and services in a standardized way. Created by Anthropic, it is supported by Claude, Cursor, VS Code (via Continue), and others.

​
What SynapseX MCP Exposes

The API Gateway seeds a small catalog by default:
ToolCategoryDescription
web-searchsearchSearch the web for information
code-interpreterexecutionExecute Python code in a sandboxed environment
file-readfilesystemRead files from the filesystem
The MCP toolkit registry contains VM operational tools such as get_metrics, tail_logs, restart_service, run_command, vuln_scan, backup_vm, and db_query.

​
Remote MCP

Use the hosted gateway when available: 
POST https://api.synapsex.ai/mcp/mcp/
Authorization: Bearer sk_...
Content-Type: application/json
List tools: 
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/list",
  "params": {}
}
Call a tool: 
{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/call",
  "params": {
    "name": "get_metrics",
    "input": { "vm_id": "vm-123" }
  }
}
The current in-repository FastAPI bridge includes the MCP toolkit router with an additional /mcp prefix. If your deployment rewrites paths, the public URL may be normalized to /mcp/; otherwise use /mcp/mcp/.

​
REST Catalog

curl https://api.synapsex.ai/v1/mcp/tools \
  -H "Authorization: Bearer sk_..."

curl https://api.synapsex.ai/v1/mcp/tools/file-read \
  -H "Authorization: Bearer sk_..."

​
Local Development

Run the bridge as a FastAPI service from source: 
cd apps/agents-synapsex/mcp-bridge
pip install -e ".[dev]"
uvicorn app:app --reload --port 8080
Then call http://localhost:8080/v1/mcp/tools or http://localhost:8080/mcp/mcp/ depending on the surface you need.