Swaps MCP Server
@agent.swaps/mcp-server is an open-source Model Context Protocol server for route intelligence. Plug it into Claude Code, Cursor, Claude Desktop, Windsurf, Gemini CLI, or any other MCP host and your agent can compare live Swaps routes across Paybis, Transak, Mercuryo, Coinbase Onramp, Bridge, and Partna. When a user is ready to continue, the MCP server returns a Swaps-owned checkout link, not an embeddable provider widget.
Compatible with all major AI hosts
The Swaps MCP plugin installs in six agent surfaces: Anthropic Claude (Claude Code + Claude Desktop), OpenAI Codex, Google Gemini CLI, Cursor, Perplexity (indexed via llms.txt + JSON-LD, not plugin-hosted), and ClawHub. One MCP server, six install paths.
Public plugin placement
The Swaps MCP plugin is published as a canonical public marketplace repository at github.com/swapsapp/swaps-plugin. First release: v1.0.0. Install in Claude Code with /plugin marketplace add swapsapp/swaps-plugin and /plugin install swaps-mcp@swaps-plugins. For Gemini CLI, paste the universal mcpServers snippet (see install matrix below) into ~/.gemini/settings.json. Cursor, Windsurf, and Claude Desktop use the same snippet in their respective MCP config files.
Who it is for
- Agents and developers that need live Swaps route intelligence.
- Support, research, and operator workflows that compare providers before checkout.
- Researchers and analysts comparing on-ramp routing across corridors, methods, and KYC tiers.
- Users who will be sent to swaps.app to review and continue the chosen route.
Tools exposed
swaps_quote — winning provider, fees, ETA, KYC tier, a Swaps checkout link, and full ranking rationale. The link opens swaps.app; it is not a direct provider widget or third-party embed URL.swaps_taxonomy — 6-axis provider taxonomy snapshot.swaps_providers_for_corridor — taxonomy filtered by country and payment method.swaps_explain_choice — post-hoc cached explain by quote ID; prefer the inline winner.explain field on swaps_quote.swaps_corridors — curated buy and sell corridors with preferred provider ordering.
Stable public endpoints
The MCP server wraps four public read-only HTTP endpoints that any language can call directly: https://agent.swaps.app/openapi.json, https://agent.swaps.app/taxonomy.json, https://agent.swaps.app/llm/quote, and https://agent.swaps.app/llm/routing-explainer. Breaking changes ship under /agent/v2/* while v1 stays live for at least six months.
Pricing
Free and open-source (MIT). No API key for read-only route intelligence. Rate-limited to 30 requests/minute per IP and 1000 requests/day per anonymous client.
Quick links
Related Pages