Skip to main content

MCP Client Setup

Overview​

This section is broken out by client. Choose the guide that matches your setup:

Before You Begin

Make sure you've completed the Getting Started guide to generate an API key and identify your regional endpoint.

Choosing an Endpoint Profile​

Each region has a full endpoint (read and write tools), a read endpoint and a write endpoint. Start with full. For every regional URL, see MCP Endpoint Profiles.

Copilot note

If you're using GitHub Copilot or Microsoft Copilot and the client reports tool-list or retrieval limits, switch to the matching regional read endpoint.

Verifying Your Setup​

After configuring your client, test the connection by asking a simple question:

"What companies do I have access to in Spotto?"

or

"Check the Spotto API status"

If the AI assistant returns information about your Spotto account, the integration is working correctly.

Troubleshooting​

Client doesn't recognize the Spotto tools​

  • Restart your AI client after updating the configuration
  • Verify the JSON syntax in your configuration file
  • Check that the URL and API key are correct
  • If the client still fails to load tools, switch from full to the regional read endpoint

"Invalid API key" errors​

  • Confirm you're using the full API key (starts with apik_)
  • Verify the key hasn't been revoked in the Spotto Portal
  • Check you're using the correct regional endpoint for your account

Connection timeouts​

  • Ensure your network allows outbound HTTPS connections
  • Check if a firewall or proxy is blocking the connection
  • Try the curl test from the Getting Started guide

Tool-limit or retrieval errors​

  • Errors such as "limiting number of tool calls to 70" or "couldn't retrieve the requested items" usually mean the client cannot handle the full Spotto catalog
  • Change the MCP URL to the matching regional read endpoint
  • Restart the client and test again