Installation

The Xpoz MCP server is hosted at https://mcp.xpoz.ai/mcp. You need an access key to authenticate — get one from your Xpoz dashboard.

Start instantly — no account needed. Generate a free token and use it in place of YOUR_API_KEY below:

curl -s -X POST https://api.xpoz.ai/api/trial/token \
  -H "Content-Type: application/json" \
  -d '{"source": "docs"}' | jq -r .data.accessKey
# -> TRIAL...  (valid 5 days, all read tools across 4 platforms)

This returns a preview of up to 5 results per call. To get full data, pagination, and CSV export, create a free account — no credit card required.

Claude Code
Claude Desktop
Gemini CLI
Cursor
N8N

Run a single command in your terminal:

claude mcp add xpoz-mcp https://mcp.xpoz.ai/mcp -t http -H "Authorization: Bearer YOUR_API_KEY"

Claude Code will automatically discover all 48 tools on the next conversation.

You can verify the connection by asking Claude: “What Xpoz tools are available?”

Open Claude Desktop
Go to Settings > Developer > Edit Config
Add the following to your configuration file:

{
  "mcpServers": {
    "xpoz": {
      "url": "https://mcp.xpoz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop

Replace YOUR_API_KEY with your actual Xpoz access key. You can find it in your Xpoz dashboard.

Add the MCP server to your Gemini CLI settings file (~/.gemini/settings.json):

{
  "mcpServers": {
    "xpoz": {
      "uri": "https://mcp.xpoz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Gemini CLI to pick up the new configuration.

Open Cursor Settings (Cmd+, / Ctrl+,)
Navigate to MCP section
Click Add new MCP server
Configure:
- Name: xpoz
- Type: http
- URL: https://mcp.xpoz.ai/mcp

Alternatively, add to your .cursor/mcp.json:

{
  "mcpServers": {
    "xpoz": {
      "url": "https://mcp.xpoz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Set the Authorization header with your bearer token. Cursor supports HTTP transport natively.

Create an AI Agent node in your workflow
Add a tool: MCP Client Tool
Configure the MCP Client Tool:

Setting	Value
Endpoint	`https://mcp.xpoz.ai/mcp`
Server Transport	HTTP Streamable
Authentication Type	Bearer Auth
Credential for Bearer Auth	Your Xpoz access key

Click Refresh to load the available tools
Select which tools to include in your agent’s toolset

If you can see the tools list after clicking Refresh, you are successfully connected to the MCP server.

Getting Your Access Key

Sign up or log in at xpoz.ai
Navigate to your dashboard
Copy your access key

You can also retrieve your access key programmatically using the getUserAccessKey tool if you are authenticated via OAuth, or check its status with checkAccessKeyStatus.

Verify the Connection

After setup, test the connection by asking your AI agent to run a simple query:

Search for Twitter user @elonmusk

If the agent successfully calls getTwitterUser and returns profile data, your connection is working.

MCP Server

MCP Tools

Installation

Getting Your Access Key

Verify the Connection

Next Steps

Browse Tools

Response Modes

​Getting Your Access Key

​Verify the Connection

​Next Steps

Browse Tools

Response Modes

Getting Your Access Key

Verify the Connection

Next Steps