Skip to main content
The Model Context Protocol (MCP) integration allows you to expose your agents and tools as MCP servers that can be connected to Claude Desktop, Cursor, VSCode, and any MCP-compatible client.

​
Overview

xpander provides three ways to use MCP:

MCP Composition

Pick and choose tools from multiple connectors and expose them as a single MCP server

Agents as MCP

Expose your AI agents as MCP servers that can be invoked from MCP clients

Single Connector

Expose an entire connector (like Slack or GitHub) as an MCP server

​
MCP Server Endpoints

Two endpoints are available: Standard MCP: 
https://api.xpander.ai/mcp/
Server-Sent Events (SSE): 
https://api.xpander.ai/mcp/sse
Authentication is provided via your API key in the request headers.
OAuth authentication (without API key) is coming soon!
Your API key is a sensitive credential. Never share it publicly or commit it to version control.

​
Configuration for Claude Desktop

Add the MCP server to Claude Desktop by editing: 
~/Library/Application Support/Claude/claude_desktop_config.json
Basic configuration format: 
{
  "mcpServers": {
    "xpander.ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.xpander.ai/mcp/",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}
Replace YOUR_API_KEY with your actual API key from app.xpander.ai.

​
Quick Setup

1

Get Your API Key

Get your API key from app.xpander.ai
2

Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "xpander.ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.xpander.ai/mcp/",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}
3

Restart Claude Desktop

Restart Claude Desktop to load the new configuration
4

Test the Connection

Ask Claude: “What agents are available?” or “List my tools”

​
Available Tools

Once connected, Claude Desktop and other MCP clients can use these tools:
  • List agents - List all available agents in your organization
  • Invoke agent - Execute an agent task
  • Create task - Create a new task for an agent
  • Get task - Retrieve task details and status
  • Get agent threads - Get conversation threads for an agent
  • Get thread messages - Retrieve messages from a specific thread

​
Use Case 1: MCP Composition

Create custom MCP servers with specific tools from the xpander console at app.xpander.ai:
  1. Go to MCP Servers → New MCP Server
  2. Select specific tools from multiple connectors
  3. Get a custom MCP URL for that composition
  4. Use the same configuration format with the custom URL

​
Use Case 2: Agents as MCP

Enable MCP for specific agents:
  1. In agent settings, go to Task Sources tab
  2. Enable the MCP toggle
  3. Get agent-specific MCP configuration
  4. Claude can invoke that specific agent

​
Use Case 3: Single Connector

Expose individual connectors (Slack, GitHub, etc.) as MCP servers:
  1. Go to Settings → Connectors
  2. Select a connector
  3. Click MCP Configuration
  4. Get connector-specific MCP URL

​
Authentication

If you’ve already authenticated connectors in xpander (Gmail, LinkedIn, Slack, etc.), they work automatically through MCP without additional authentication in Claude.

​
Testing Your MCP Integration

After configuration, test by asking Claude:
  • “What agents are available?”
  • “List my agents”
  • “Invoke my data analysis agent to analyze this data”
  • “Create a task for my support agent”
  • “What’s the status of task xyz?”
Claude will use the MCP tools to interact with your agents and tasks.

​
Example Configurations

  • Standard MCP
  • SSE Endpoint
{
  "mcpServers": {
    "xpander.ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.xpander.ai/mcp/",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}
Replace YOUR_API_KEY with your own credentials. Never commit API keys to version control.

​
Supported MCP Clients

xpander MCP servers work with:
  • Claude Desktop - Anthropic’s desktop application
  • Cursor - AI-powered code editor
  • VSCode - With MCP extension
  • Any MCP-compatible client - Following the Model Context Protocol specification

​
Roadmap

Coming Soon: OAuth authentication support, allowing you to connect without manually managing API keys.

​
Next Steps

Setup Guide

Complete MCP setup with screenshots

REST API

Manage agents via REST API

Python SDK

Build agents with the SDK