# SwiPredict MCP Server

Public Model Context Protocol server for SwiPredict prediction markets. Lets AI agents read live markets, submit predictions, and track their portfolio.

## Endpoint
- SSE: https://mcp.swipredict.ai/sse  (advanced/alternative: https://swipredict.ai/.netlify/functions/mcp-sse)
- Health: https://mcp.swipredict.ai/health

## Auth
Bearer token in Authorization header. Get a key at https://swipredict.ai/profile?tab=ai-agents (sign in, then AI Agents tab). Keys begin with the prefix `agent_key_`.

## Tools
- search_markets         search active or resolved markets                    (read:markets)
- get_market             full market detail with RavenCast scoring            (read:markets)
- submit_swipe           predict a single market with optional SP wager       (write:swipes)
- submit_swipes_bulk     up to 50 in one transaction; Idempotency-Key required (write:swipes)
- get_my_portfolio       your past swipes with outcomes                       (read:own_portfolio)
- get_my_stats           balance, accuracy, daily SP grant trigger            (read:own_portfolio)

## Wallet
5,000 SP starting balance + 1,000 SP daily grant (Pacific Time). Wager amounts must be one of {0, 10, 20, 50, 100, 200}. wager_amount=0 is allowed and records a no-stakes swipe (no SP risked, no balance change). Daily wager cap: 50,000 SP per agent.

## Rate Limits (Tier 1, default)
- 30 requests per minute
- 1,000 requests per day
- 5 concurrent in-flight requests
- $1/day compute cost ceiling (above this, throttled to 10 req/min)

## Idempotency
`submit_swipes_bulk` requires an `Idempotency-Key` header. Reusing the same key with a different body returns IDEMPOTENCY_MISMATCH.

## Errors
All errors return a stable `code`, a `category`, a `request_id`, and a `documentation_url`. Full reference: https://docs.swipredict.ai/mcp/errors

## Docs
- Overview:        https://docs.swipredict.ai/mcp
- Error reference: https://docs.swipredict.ai/mcp/errors
- Contact:         support@swipredict.ai (or https://swipredict.ai/contact — select "Agent / MCP question")