Spreetail MCP Server

The Spreetail MCP server gives AI-powered tools direct access to Spreetail API operations. If you already use the Spreetail API, you can connect your AI editor using the login credentials provided by Spreetail — no API keys or secrets go into your configuration.

Who Can Use This

You must be an existing Spreetail API user. To get MCP server access, have your Account Manager request login credentials for you. Once we provide your credentials, you can connect immediately — no additional setup required.

How It Works

The Spreetail MCP server uses browser-based login, similar to how you sign in to a website:

You add the server URL to your AI tool's configuration (see below)
The first time you use a Spreetail tool, your AI assistant will ask you to log in
Your browser opens automatically to a login page
You sign in with the login credentials provided by Spreetail (sent to you after your Account Manager requests access)
Once signed in, your session lasts 8 hours — one login per workday

No API keys, tokens, or secrets go into your configuration file. You only need your Spreetail-provided login credentials when the browser prompts you to sign in.

Setup

Add the Spreetail MCP server to your AI tool's configuration file:

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "spreetail": {
      "url": "https://api.spreetail.com/mcp"
    }
  }
}

Add to claude_desktop_config.json:

The config file location depends on your operating system:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "spreetail": {
      "url": "https://api.spreetail.com/mcp"
    }
  }
}

First-Time Login

After adding the configuration and restarting your AI tool:

Start a new conversation with your AI assistant
Ask it to do something with Spreetail — for example, "Show me my recent orders"
The assistant will trigger a login flow:
- Your default browser opens to a login page
- You will see a confirmation code displayed in your AI tool — verify it matches what the browser shows
- Sign in with your Spreetail-provided login credentials
- Once approved, return to your AI tool
The assistant confirms authentication succeeded and proceeds with your request

If your browser does not open automatically, the assistant will display a URL and a short code. Open that URL manually, enter the code, and sign in.

Session Duration

Your login session lasts 8 hours — you only need to sign in once per workday
If your session expires mid-conversation, the assistant will prompt you to log in again
Each AI tool maintains its own session — logging in on Cursor does not log you in on Claude Desktop

Troubleshooting

Problem	Solution
"Server not found" or connection error	Verify the URL is exactly `https://api.spreetail.com/mcp` with no trailing slash
Browser does not open	Copy the URL shown by your AI assistant and open it manually
Login page says "access denied"	Your login credentials may not be provisioned yet — contact your Account Manager
Tools stop working after a few hours	Your session expired — ask the assistant to authenticate again
Changes not taking effect	Restart your AI tool after editing the configuration file

What You Can Do

Once connected, your AI assistant can help with Spreetail API operations directly in your conversation. Ask it things like:

"Show me my available Spreetail tools"
"What orders are pending for my account?"
"Help me check inventory levels"

The assistant has access to the same operations available through the Spreetail API, scoped to your account permissions.