Overview

The Spot Model Context Protocol (MCP) server allows AI-powered developer tools - such as Cursor, Windsurf, Claude Desktop, and others - to read your Spot documentation, call Spot APIs, and help you build integrations more quickly.

Instead of manually looking up endpoints or stitching code together, your editor’s AI can use MCP to directly access Spot’s APIs and docs in real time, giving you tailored, context-aware help while you work.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI applications securely connect to external APIs, tools, and data.

When connected to Spot’s MCP server, AI agents inside your IDE or desktop environment can:

• Call Spot APIs on your behalf (e.g., generate a quote, accept/decline a quote, inspect webhook payloads)
• Search and reference Spot documentation without you having to open a browser
• Generate ready-to-use code for Spot integrations (checkout flows, backend services, token handling, etc.)
• Debug API requests by testing endpoints directly through the AI tool (e.g., “Why am I getting NO_MATCHING_QUOTE?”)

Spot MCP Server Setup

Spot hosts a remote MCP server at https://docs.getspot.com/mcp.

Connect your AI development tools to this server. If your APIs require authentication, you can pass in headers via query parameters or however headers are configured in your MCP client.

claude mcp add getspot -t http -s user -- https://docs.getspot.com/mcp

{
  "mcpServers": {
    "getspot": {
      "url": "https://docs.getspot.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "getspot": {
      "url": "https://docs.getspot.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "getspot": {
      "url": "https://docs.getspot.com/mcp"
    }
  }
}

Testing Your MCP Setup

Once configured:

1. Open your AI editor (Cursor, Windsurf, etc.)
2. Start a new chat with the AI assistant
3. Ask it something Spot-specific - such as:
   • "Generate a quote request for a 1-day lift ticket."
   • "Show me the correct payload for accepting a quote."
   • “Build a Node.js service that fetches a bearer token and accepts quotes.”
   • “Why would I receive NO_MATCHING_QUOTE?”

If the setup is correct, the AI assistant will now:

• read from Spot’s documentation,
• call the Spot API through MCP (when configured with credentials),
• and return context-aware answers tailored to your account and integration flow.