Skip to main content
Glama
Travisswop

swop-mcp

by Travisswop
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

swop-mcp

Remote MCP server exposing Swop to AI assistants (Claude, ChatGPT, Grok, Cursor — anything that speaks MCP). One server, registered per platform.

Phase 1 (this code): public read-only tools, no auth. Phase 2 adds an OAuth 2.1 facade + authed reads and non-signing writes (profile/SmartSite/products). Phase 3 adds on-chain writes (swap/send/bets/DeFi) via Privy delegated signing with caps + in-app confirm-link fallback.

Tools

Identity (swop-app-backend /api/v5/identity, public CORS-open router):

  • swop_search_identities / swop_lookup_identity — handle → profile + wallet addresses. ⚠️ On the production branch but NOT yet live on apps.apiswop.co (404) — needs a backend prod deploy via deploy-prod.sh before these tools return data.

Predictions (polymarket.apiswop.co, all public):

  • swop_search_markets (free-text via /desktop/markets), swop_get_event_markets, swop_get_event_live_status, swop_get_orderbook, swop_get_prices (live book, preferred over cached outcomePrices), swop_get_price_history, swop_get_taxonomy, swop_get_taxonomy_stats, swop_check_predictions_access (geoblock).

Related MCP server: Polymarket MCP Server

Run

npm install
npm run dev          # Streamable HTTP on :8788 (POST /mcp), stateless JSON mode
npm run dev:stdio    # stdio transport for local clients
npm run build && npm start

Env: SWOP_API_BASE (default https://apps.apiswop.co), PREDICTIONS_API_BASE (default https://polymarket.apiswop.co), PORT (default 8788).

Local test with Claude Code:

claude mcp add swop --transport http http://localhost:8788/mcp

Deploy

Stateless — any host works (Vercel functions, or a small box alongside the sidecar). Suggested prod URL: mcp.swopme.app (never swop.tech). Give it its own upstream rate-limit identity before public listing.

Where this fits

The AI-assistant edge of the platform. Exposes Swop to anything that speaks MCP, reaching the same API every first-party client uses.

graph LR
    ai["Claude / ChatGPT / Cursor"] --> mcp["<b>swop-mcp</b>"]
    mcp --> api["swop-app-backend<br/>apps.apiswop.co"]

The identity rule that matters here: crypto payment is never KYC-gated. An agent can pay a seller in USDC with no verification step. Verification gates the card scope only — never ask a crypto path for identity.

For the cross-repo map, see swop-app-backend/docs/ECOSYSTEM.md.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Polymarket MCP Server

    rafael-pina
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.
    20 npm
    6
    MIT

  • Polymarket MCP Server

    yigitabi5444
    A
    license
    B
    quality
    D
    maintenance
    Enables comprehensive read access to Polymarket prediction market data, including live prices, order books, and market statistics. It allows AI assistants to analyze events, search markets, and monitor real-time signals without requiring API keys or authentication.
    22
    1
    MIT

  • polymarket-mcp

    pab1it0
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to query Polymarket prediction markets and analyze market data through the MCP interface.
    8
    -