Give agents route intelligence, not execution authority
@agent.swaps/mcp-server is an open-source Model Context Protocol server for route intelligence. Install it when an agent needs to compare Swaps routes, inspect provider taxonomy, explain routing decisions, and return a Swaps-owned checkout link for human review.
MCP route contract
- Agent asks - the request includes corridor, amount, asset, country, and payment method context.
- Read-only tools answer - the MCP server returns quote context, taxonomy, provider rationale, or corridor data.
- Swaps link opens review - checkout remains a human-reviewed Swaps journey before provider handoff.
Compatible agent surfaces
The Swaps MCP plugin installs through the Claude Code marketplace when possible. Other MCP-aware hosts can use the same npx -y @agent.swaps/mcp-server@1.0.1 config. Perplexity discovery works through public index surfaces such as llms.txt, JSON-LD, OpenAPI, and agent.swaps.app endpoints rather than hosted plugin installation.
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 for human review before provider checkout.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.
Execution boundaries
The MCP server is read-only. It does not execute provider checkout, wallet signing, or payment movement. The live Swaps quote owns route comparison, and the selected provider owns KYC, payment acceptance, pricing changes, and execution after handoff.
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