MCP Server Setup

The Polystrike MCP server enables Claude Desktop to access tweet data, market metadata, and predictions through natural language. No local installation required — the server runs on our infrastructure. The free tier needs no signup and no API key: paste one config block and you’re connected. An API key is only needed for the PRO tools (trading signals and portfolio analysis).

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude connect to external data sources and tools. Instead of copying/pasting API responses, Claude can query Polystrike directly and reason about the data in real-time.

Benefits:

• Natural language queries: “What are the current Elon market predictions?”
• Automatic data refresh: Claude always sees live data
• Portfolio analysis: “Analyze my positions at 0x…” (PRO)
• Trading signals: “Show me BUY signals with $100 bankroll” (PRO)

Prerequisites

• Claude Desktop (macOS, Windows, or Linux)
• Node.js (for npx, which runs the mcp-remote bridge)

That’s it — no account and no API key for the free tier.

Setup

1. Configure Claude Desktop

Open your Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "polystrike": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://polystrike.xyz/mcp"
      ]
    }
  }
}

No API key, no placeholders to replace.

Note

The mcp-remote package bridges Claude Desktop’s stdio transport to our streamable-HTTP server at https://polystrike.xyz/mcp. It’s automatically downloaded by npx — no manual installation needed. (The older https://polystrike.xyz/mcp/sse endpoint still works, but new setups should use /mcp.)

2. Restart Claude Desktop

Important: Completely quit Claude Desktop (Cmd+Q on macOS, not just close the window) and restart to load the configuration.

3. Test It

Try these prompts in Claude:

Check Polystrike API health

What are the current predictions for active Elon markets?

Show me recent Elon tweets

If everything is working, Claude will respond with live data from Polystrike.

Optional: PRO API Key

Three tools — get_trading_signals, analyze_portfolio, and get_rebalancing_recommendations — require a PRO API key. If you only want market data and predictions, skip this section entirely.

Get a key at polystrike.xyz, then add the x-api-key header to your config:

{
  "mcpServers": {
    "polystrike": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://polystrike.xyz/mcp",
        "--header",
        "x-api-key:${POLYSTRIKE_API_KEY}"
      ],
      "env": {
        "POLYSTRIKE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with your actual API key, then restart Claude Desktop again. A PRO key also raises your rate limit (see Rate Limits).

Example PRO prompt:

Get trading signals for Elon markets with $100 bankroll

Available Tools

FREE Tier (No API Key Required)

• get_market_metadata - Active Elon tweet markets
• get_crypto_metadata - Crypto market information
• get_recent_tweets - Recent tweets (15 limit)
• get_predictions - Market predictions (limited)
• check_health - API health status
• join_waitlist - Registration

PRO Tier (API Key Required)

• get_trading_signals - EV-based signals with Kelly sizing
• analyze_portfolio - Wallet position analysis
• get_rebalancing_recommendations - Position rebalancing

Troubleshooting

Tools Not Appearing

1. Check Claude Desktop logs for errors
2. Verify JSON syntax in config file (use jsonlint.com)
3. Restart Claude Desktop completely (Cmd+Q, not just close window)

Connection Errors

Test server connectivity:

curl https://polystrike.xyz/mcp/health

Expected response:

{"status":"ok","version":"1.0.0","server":"polystrike"}

If this fails, the server may be down. Check status.polystrike.xyz or contact support.

Authentication Errors (PRO tools only)

The free-tier tools never require authentication — if you see auth errors on get_trading_signals, analyze_portfolio, or get_rebalancing_recommendations:

• Verify your API key is correct (check for extra spaces)
• Check API key tier (FREE vs PRO)
• Ensure key is not expired
• Try regenerating your key at polystrike.xyz

Tool Calls Timeout or Fail

If Claude can see the tools but calls fail:

1. Check your internet connection

2. Verify the MCP server is responding:

   curl -X POST https://polystrike.xyz/mcp

   Should return: "Invalid Content-Type header" (not 404)

3. Check Claude Desktop logs for specific error messages

Rate Limits

• FREE Tier: 100 requests/hour
• PRO Tier: 10,000 requests/hour

Rate limits are enforced server-side. If you hit the limit, Claude will receive an error message and you’ll need to wait or upgrade.

Why MCP vs Direct API?

Approach	Setup	Updates	Natural Language
MCP Server	2 lines config	Automatic	Yes
Direct API	Manual curl/code	Manual	No

MCP is the recommended approach for Claude Desktop users. It’s simpler, automatically updated, and enables natural language queries.

Support

• Documentation: docs.polystrike.xyz
• Issues: github.com/dizpers/polystrike/issues
• Contact: @dizpers on Telegram