Skip to main content

Getting Started with Spotto MCP

This guide walks you through connecting the Spotto MCP server to your AI client.

Prerequisites​

Before you begin, ensure you have:

  • A Spotto account with at least one connected Azure subscription
  • Access to the Spotto Portal
  • An MCP-compatible AI client installed (Claude Code, Cursor, Windsurf, etc.)

Step 1: Get Your API Key​

You'll need a Spotto API key to authenticate MCP requests. If you don't have one yet, follow the API Authentication guide to generate a key.

When creating your key, consider naming it something descriptive like "Claude Code MCP" or "Cursor Integration" so you can identify it later.

Step 2: Choose Your Endpoint​

Select the MCP endpoint that matches your Spotto account region:

RegionMCP Endpoint
Australiahttps://mcp-au.spotto.ai/mcp
United Stateshttps://mcp-us.spotto.ai/mcp
Europehttps://mcp-eu.spotto.ai/mcp

Not sure which region you're in? Check the URL when you log into the Spotto Portal—it includes your region code (e.g., portal-au.spotto.ai).

Step 3: Test Connectivity​

Before configuring your AI client, you can verify the MCP server is reachable using curl:

curl -X POST https://mcp-au.spotto.ai/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Replace YOUR_API_KEY with your actual API key and adjust the endpoint for your region.

A successful response returns a JSON object listing available tools:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {"name": "get-api-status", "description": "Check API health and connectivity"},
      {"name": "get-current-user", "description": "Get your user profile and permissions"},
      ...
    ]
  }
}

If you receive an authentication error, double-check your API key and ensure it hasn't been revoked.

Step 4: Configure Your Client​

Now you're ready to set up your AI client. Head to the Client Setup guide for specific instructions for:

  • Claude Code CLI
  • Claude Desktop
  • Cursor
  • Windsurf
  • OpenAI Codex CLI
  • Generic HTTP clients

Troubleshooting​

"Authentication failed" or 401 errors​

  • Verify your API key is correct and hasn't been revoked
  • Check that you're using the correct regional endpoint
  • If IP allowlisting is enabled, ensure your current IP is in the allowlist

See the API Authentication troubleshooting section for more details.

"Connection refused" or timeout errors​

  • Confirm you have internet connectivity
  • Check if your network blocks outbound HTTPS traffic
  • Try the curl test above to isolate whether it's a client or server issue

"No tools available" in your AI client​

  • Some clients cache the tool list—try restarting the client
  • Verify the MCP server configuration is correct in your client settings
  • Run the curl test to confirm the server returns tools

Next Steps​