{"_id":"@agent.swaps/mcp-server","_rev":"3-4114f28e0e0932dd7e29270098a60bbd","name":"@agent.swaps/mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@agent.swaps/mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","anthropic","claude","claude-code","cursor","swaps","crypto","onramp","offramp","agentic","ai-agent"],"license":"MIT","_id":"@agent.swaps/mcp-server@1.0.0","maintainers":[{"name":"mutuel","email":"id@swaps.app"}],"homepage":"https://agent.swaps.app","bugs":{"url":"https://github.com/swapsapp/swaps/issues"},"bin":{"swaps-mcp":"dist/index.js"},"dist":{"shasum":"43beeb2913806ad2ac90ec25e90821833b6a2ce4","tarball":"https://registry.npmjs.org/@agent.swaps/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":7,"integrity":"sha512-aoiALH3YWYPcjB/bmKRV7cwmXpdaKXCQPsMx2sQZcAakn/n0Gl5VQWYuDmFu31RatCXnu/mowA6uplXlEh0msg==","signatures":[{"sig":"MEYCIQD9M8gP7X746XwRvla9clSdMQUqr4PC9lLaFTeQT/Mj2gIhAKlBmWNkRVPcu5aFc94LV5wohwLkd7c6xFJPRh5qlYfb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25652},"main":"./dist/index.cjs","type":"module","_from":"file:agent.swaps-mcp-server-1.0.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"dev":"tsup --watch","build":"tsup"},"_npmUser":{"name":"mutuel","email":"id@swaps.app"},"_resolved":"/Users/georgioskalmpazidis/.tmp/5b664e7bec4be22c73605169bde042d6/agent.swaps-mcp-server-1.0.0.tgz","_integrity":"sha512-aoiALH3YWYPcjB/bmKRV7cwmXpdaKXCQPsMx2sQZcAakn/n0Gl5VQWYuDmFu31RatCXnu/mowA6uplXlEh0msg==","repository":{"url":"git+https://github.com/swapsapp/swaps.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Swaps — the agent-native crypto on-ramp aggregator. Adds five tools (swaps_quote, swaps_taxonomy, swaps_providers_for_corridor, swaps_explain_choice, swaps_corridors) to Claude Code, Cursor, Claude Desktop, Windsurf, and ","directories":{},"_nodeVersion":"22.19.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1778589805274_0.04164812200829493","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agent.swaps/mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","anthropic","claude","claude-code","cursor","swaps","crypto","onramp","offramp","agentic","ai-agent"],"license":"MIT","_id":"@agent.swaps/mcp-server@1.0.1","maintainers":[{"name":"mutuel","email":"id@swaps.app"}],"homepage":"https://agent.swaps.app","bugs":{"url":"https://github.com/swapsapp/swaps-mcp-server/issues"},"bin":{"swaps-mcp":"dist/index.js"},"dist":{"shasum":"27ce5d1c8336550b43ca2f3325b4315e68df6371","tarball":"https://registry.npmjs.org/@agent.swaps/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":8,"integrity":"sha512-ZB+6B/xnoUaNUocrw6SjpgYuHuV0Tu3MDvlARij2DoCj2UqeShEi652wvvomrMsU6hiCBN6HBNWuG6VBvS392w==","signatures":[{"sig":"MEUCIQDC78rQaM0Yh+HvEA9y/DTmKBaiCfISc8ANLqF15D0WXQIgJIvpagwYd36fdb6UgNtebTwrpu73LvTg0Yyh9JgmGS4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29884},"main":"./dist/index.cjs","type":"module","_from":"file:agent.swaps-mcp-server-1.0.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"dev":"tsup --watch","build":"tsup"},"_npmUser":{"name":"mutuel","email":"id@swaps.app"},"_resolved":"/Users/georgioskalmpazidis/.tmp/57a6622c801634ae7c7f139250303ec2/agent.swaps-mcp-server-1.0.1.tgz","_integrity":"sha512-ZB+6B/xnoUaNUocrw6SjpgYuHuV0Tu3MDvlARij2DoCj2UqeShEi652wvvomrMsU6hiCBN6HBNWuG6VBvS392w==","repository":{"url":"git+https://github.com/swapsapp/swaps-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Swaps — the agent-native crypto on-ramp aggregator. Adds five tools (swaps_quote, swaps_taxonomy, swaps_providers_for_corridor, swaps_explain_choice, swaps_corridors) to Claude Code, Cursor, Claude Desktop, Windsurf, and ","directories":{},"_nodeVersion":"22.19.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1778645173665_0.3144574491916403","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@agent.swaps/mcp-server","version":"1.1.0","description":"Model Context Protocol server for Swaps route intelligence. Five read-only tools (swaps_quote, swaps_taxonomy, swaps_providers_for_corridor, swaps_explain_choice, swaps_corridors) plus legal:// resources (Terms, Privacy, Risk, AUP, Sanctions, API Terms, S","license":"MIT","homepage":"https://agent.swaps.app","repository":{"type":"git","url":"git+https://github.com/swapsapp/swaps.git","directory":"packages/mcp-server"},"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"bin":{"swaps-mcp":"dist/index.js"},"scripts":{"build:legal":"node scripts/build-legal-content.mjs","build":"node scripts/build-legal-content.mjs && tsup","dev":"node scripts/build-legal-content.mjs && tsup --watch"},"keywords":["mcp","model-context-protocol","anthropic","claude","claude-code","cursor","swaps","crypto","onramp","offramp","agentic","ai-agent"],"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0","zod-to-json-schema":"^3.23.0"},"devDependencies":{"tsup":"^8.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"publishConfig":{"access":"public"},"_id":"@agent.swaps/mcp-server@1.1.0","bugs":{"url":"https://github.com/swapsapp/swaps/issues"},"_nodeVersion":"22.19.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-KCy5FMc4jq2+SneZ51YlWDjlh5/ELnfkNt3QcDPyB2zaB7o12bQszRCcUC3kYKB5RnxAQv1ZQ4QpPUddvJS5oQ==","shasum":"4b59b3c325329689a74ae442d30758437c13c3c6","tarball":"https://registry.npmjs.org/@agent.swaps/mcp-server/-/mcp-server-1.1.0.tgz","fileCount":6,"unpackedSize":394807,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCF3qN3qjJqaUOPxNDwzFDTAoIgYBzK8bFDY93UqesgWAIhAKNBy4lSE19M3g3ZoH3JRCE7Dy5Nm+jDALXcZuS9UHRm"}]},"_npmUser":{"name":"mutuel","email":"id@swaps.app"},"directories":{},"maintainers":[{"name":"mutuel","email":"id@swaps.app"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.1.0_1779344388682_0.20343042201302675"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T12:43:25.166Z","modified":"2026-05-21T06:19:48.992Z","1.0.0":"2026-05-12T12:43:25.408Z","1.0.1":"2026-05-13T04:06:13.815Z","1.1.0":"2026-05-21T06:19:48.866Z"},"bugs":{"url":"https://github.com/swapsapp/swaps/issues"},"license":"MIT","homepage":"https://agent.swaps.app","keywords":["mcp","model-context-protocol","anthropic","claude","claude-code","cursor","swaps","crypto","onramp","offramp","agentic","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/swapsapp/swaps.git","directory":"packages/mcp-server"},"description":"Model Context Protocol server for Swaps route intelligence. Five read-only tools (swaps_quote, swaps_taxonomy, swaps_providers_for_corridor, swaps_explain_choice, swaps_corridors) plus legal:// resources (Terms, Privacy, Risk, AUP, Sanctions, API Terms, S","maintainers":[{"name":"mutuel","email":"id@swaps.app"}],"readme":"# @agent.swaps/mcp-server\n\n> Model Context Protocol server for **Swaps** route intelligence. Five read-only tools let LLM agents compare crypto purchase routes across 6 licensed providers, reason about provider trade-offs, and explain routing decisions.\n\n`★ What this is ─────────────────────────────────`\nSwaps aggregates Paybis, Transak, Mercuryo, Coinbase, Bridge, and Partna into a first-party checkout journey across 190 countries and 34+ payment methods. With `@agent.swaps/mcp-server`, your AI agent can:\n\n- Compare provider rates in real time, _with the explanation of why each won or lost_\n- Reason about which provider fits a use case using the canonical 6-axis taxonomy\n- Hand off the user to a Swaps-owned checkout link when ready to buy\n\nNo API key required for v1. The server is for read-only route intelligence; it does not expose provider checkout widgets for external embedding or third-party distribution.\n`─────────────────────────────────────────────────`\n\n## Install\n\n### Claude Code (`~/.claude/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"swaps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent.swaps/mcp-server\"]\n    }\n  }\n}\n```\n\n### Cursor (`.cursor/mcp.json` in your project root)\n\n```json\n{\n  \"mcpServers\": {\n    \"swaps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent.swaps/mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Desktop (`claude_desktop_config.json`)\n\nSame shape as Claude Code. On macOS the file lives at:\n`~/Library/Application Support/Claude/claude_desktop_config.json`\n\n### Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"swaps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent.swaps/mcp-server\"]\n    }\n  }\n}\n```\n\n### ChatGPT Apps (Apps SDK)\n\nThe MCP HTTP/SSE transport variant for ChatGPT Apps ships in a future release. For now, stdio works in any local development setup.\n\n## Tools\n\n### `swaps_quote`\n\nGet the best on-ramp or off-ramp quote across all 6 fiat providers.\n\n**Input:**\n\n- `from` (string, required): ISO fiat or crypto symbol the user is paying with (e.g. `\"USD\"`, `\"USDT\"`)\n- `to` (string, required): Crypto symbol the user wants to receive (e.g. `\"BTC\"`)\n- `amount` (string, required): Decimal amount in source currency (e.g. `\"100\"`)\n- `country` (string, required, 2 chars): ISO-3166-1 alpha-2 country code (e.g. `\"US\"`, `\"DE\"`)\n- `side` (`\"buy\"` | `\"sell\"`, optional, default `\"buy\"`)\n- `method` (string, optional): Payment-method slug — `card`, `sepa`, `ach`, `pix`, `apple-pay`, etc.\n\n**Returns:** `LLMQuoteResponse` with the winning provider, ranked alternatives, a Swaps checkout link, and a structured `LLMExplainPayload` per quote. The checkout link opens swaps.app; it is not a direct provider widget or third-party embed URL. See [agent.swaps.app/openapi.json](https://agent.swaps.app/openapi.json) for the full schema.\n\n### `swaps_taxonomy`\n\nGet the full 6-axis taxonomy of all 11 Swaps providers: Domain · Flow shape · Integration · Settlement rail · User constraints · Agentic exposure.\n\n**Input:** none.\n\n**Returns:** machine-readable JSON sourced from [agent.swaps.app/taxonomy.json](https://agent.swaps.app/taxonomy.json).\n\n### `swaps_providers_for_corridor`\n\nFilter the taxonomy down to candidates for a specific country and payment method.\n\n**Input:**\n\n- `country` (string, required, 2 chars)\n- `paymentMethod` (string, optional)\n\n**Returns:** list of fiat-ramp provider candidates.\n\n### `swaps_explain_choice`\n\nGet the post-hoc explanation for a previously-issued `quoteId`. Useful when the agent already discarded the original `swaps_quote` response but needs to re-justify a decision.\n\n**Input:**\n\n- `quoteId` (string, required): from a previous `swaps_quote` call\n\n**Returns:** the `LLMExplainPayload` for winner + alternatives. Returns `EXPLAIN_EXPIRED` if the cache (TTL ~10 min) has elapsed — re-call `swaps_quote` to recover.\n\n### `swaps_corridors`\n\nGet the curated top 14 buy + sell corridors with preferred-provider ordering.\n\n**Input:** none.\n\n**Returns:** corridor-to-provider matrix mirroring the `## Corridor Matrix` section of [swaps.app/llms.txt](https://www.swaps.app/llms.txt).\n\n## Resources\n\nIn addition to the five tools above, `@agent.swaps/mcp-server` exposes Swaps' legal and compliance documentation as MCP resources, so agents can read Terms, Privacy, Risk, Sanctions, AUP, API Terms, Search Terms, and the rest without leaving the agent context.\n\n**URI scheme:** `legal://swaps/<slug>`\n**mimeType:** `text/markdown`\n\n| Slug                               | Document                                                              |\n| ---------------------------------- | --------------------------------------------------------------------- |\n| `legal://swaps/imprint`            | Legal Notice (Imprint) — Supa Labs OÜ, Estonian registry 17399414     |\n| `legal://swaps/about`              | About Swaps — what it is and is not                                   |\n| `legal://swaps/terms`              | Terms of Service                                                      |\n| `legal://swaps/privacy`            | Privacy Policy (GDPR / UK GDPR / CCPA / LGPD / DPDP)                  |\n| `legal://swaps/cookies`            | Cookie Policy (4-category model)                                      |\n| `legal://swaps/risk`               | Risk Disclosure                                                       |\n| `legal://swaps/ai-disclosure`      | AI-Generated Content Disclosure                                       |\n| `legal://swaps/aup`                | Acceptable Use Policy                                                 |\n| `legal://swaps/aml`                | AML Statement (Swaps is **not** AML-obligated; providers perform KYC) |\n| `legal://swaps/sanctions`          | Sanctions & Restricted Jurisdictions                                  |\n| `legal://swaps/limits-enforcement` | Limits & Enforcement                                                  |\n| `legal://swaps/referral-terms`     | Friend Rate Referral Programme Terms                                  |\n| `legal://swaps/api-terms`          | Developer / API / MCP Terms                                           |\n| `legal://swaps/search-terms`       | Search Address Report — Consumer Terms                                |\n| `legal://swaps/dpa-template`       | Data Processing Addendum — Template (B2B)                             |\n\nEach resource returns the canonical markdown from the [Swaps repo](https://github.com/swapsapp/swaps/tree/main/docs/legal) at the version that ships with this package. Bundled at build time — no runtime filesystem or network access required.\n\n### Why this matters for AI agents\n\nIf your agent recommends a Swaps redirect, it can quote the **Terms** to its user, point at the **Risk Disclosure** for \"things to know,\" and consult the **API Terms** for human-in-the-loop and attribution requirements — all from the same MCP session.\n\nAgents building checkout flows on top of Swaps **must** comply with [Developer / API / MCP Terms](https://www.swaps.app/legal/api-terms):\n\n- Keep a **human in the loop** for any transaction. Do not chain Swaps' quote output into automated trade execution.\n- Tell the user that quotes are **previews**, not binding (the provider's quote at checkout is binding).\n- Attribute Swaps as the data source.\n\n## Example prompts\n\nAfter installing the server, try these in your MCP-aware host:\n\n> Use the swaps_quote tool to find the cheapest way to buy 100 USD of BTC in the United States.\n\n> Compare the available on-ramp providers for buying USDT in India with bank transfer. Use swaps_providers_for_corridor and then swaps_quote.\n\n> Find the best way to buy 200 EUR of USDC in Germany via SEPA. Call swaps_quote, then explain the winner using the inline winner.explain field.\n\n## Environment overrides\n\n| Variable                   | Default                       | Purpose                        |\n| -------------------------- | ----------------------------- | ------------------------------ |\n| `SWAPS_AGENT_BASE_URL`     | `https://agent.swaps.app`     | Primary host for all API calls |\n| `SWAPS_AGENT_FALLBACK_URL` | `https://www.swaps.app/agent` | Used on 5xx fallback           |\n\n## Stability commitment\n\n- Tool names and input schemas are versioned — breaking changes ship a new tool name (e.g. `swaps_quote_v2`); the old tool stays live for ≥6 months.\n- The underlying HTTP API is contracted at [`agent.swaps.app/openapi.json`](https://agent.swaps.app/openapi.json). Schema changes are additive within `info.version` minor bumps.\n\n## Links\n\n- Spec: https://agent.swaps.app/openapi.json\n- Taxonomy: https://agent.swaps.app/taxonomy.json\n- LLM manifest: https://www.swaps.app/llms.txt\n- Source: https://github.com/swapsapp/swaps-mcp-server\n- Issues: https://github.com/swapsapp/swaps/issues\n\n## License\n\nMIT\n","readmeFilename":"README.md"}