// docs · mcp

The Motion MCP server.

Hook Motion into Claude Desktop, Cursor, or any MCP-compatible client. The full prompt catalog becomes a native tool your AI agent can browse, search, and read on its own.

Endpoint

https://motion.shegerpay.com/api/mcp

Transport: Streamable HTTP. Protocol version 2025-06-18.

Tools exposed

list_prompts
List catalog metadata. Optional filters: category, tier, tag.
get_prompt
Fetch the full body of one prompt by id. This is what your agent pastes into the build step.
search_prompts
Relevance-scored full-text search. Pass any natural-language query.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "motion": {
      "url": "https://motion.shegerpay.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mtn_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. The Motion tools will appear in the tool list.

Cursor

Settings → MCP → Add server:

{
  "name": "motion",
  "transport": "http",
  "url": "https://motion.shegerpay.com/api/mcp",
  "headers": { "Authorization": "Bearer mtn_live_xxxxxxxxxxxxxxxxxxxxxxxx" }
}

Direct JSON-RPC

For custom agents, POST a JSON-RPC 2.0 request to the endpoint:

curl -X POST https://motion.shegerpay.com/api/mcp \
  -H "Authorization: Bearer mtn_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_prompt",
      "arguments": { "id": "stellar-ai" }
    }
  }'