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

Spotto publishes three MCP endpoint profiles in each region:

Profile	Use it when
`full`	You want the complete Spotto tool catalog in one server
`read`	You mostly need analysis and read-only queries, or your client struggles with the full catalog
`write`	You want action tools only

For the full regional matrix, 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?"

"Check the Spotto API status"

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

Regional Endpoints Reference

Region	Default `full` endpoint
Australia	`https://mcp-au.spotto.ai/mcp`
United States	`https://mcp-us.spotto.ai/mcp`
Europe	`https://mcp-eu.spotto.ai/mcp`

Use MCP Endpoint Profiles for the matching -read and -write URLs.

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

Overview​

Choosing an Endpoint Profile​

Verifying Your Setup​

Regional Endpoints Reference​

Troubleshooting​

Client doesn't recognize the Spotto tools​

"Invalid API key" errors​

Connection timeouts​

Tool-limit or retrieval errors​