# Swaplume [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://swaplume.com/  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/swaplume

## Description
Remote MCP server for comparing live instant crypto swap offers from 9 exchanges and creating a swap. Free, no authentication. Swaplume never holds user funds; the chosen exchange carries out the swap.

## Tools
Capabilities this server exposes over MCP:

- **get_quotes** — Compare every exchange's offer for a swap, best first.

In each quote, amount_to is what the user receives after all fees. With amount_to given instead of amount,
quotes are sorted by amount_from, what the user sends. errors lists the exchanges that can't, and why (with
their min/max when the amount is out of range); with no quote at all, limits has the widest min/max: suggest
an amount inside it. savings_pct: how much more the best quote gives than the worst. Ask again after
refresh_after seconds, not sooner.
- **create_swap** — Create the swap and get the deposit address. No funds move here: the user then sends amount_from of
from_asset to deposit_address (with deposit_extra_id as the memo, when present), as instructions says.
Follow it with get_swap.
- **validate_address** — Check a payout or refund address (create_swap runs the same check). valid: true; false: show reason to the
user and ask again; null: this network's format isn't checked here. extra_id_name: the asset uses a
memo/tag.
- **get_swap** — A swap's live status: waiting (for the deposit), confirming, exchanging, sending, finished, failed,
refunding, refunded, expired, verifying (held for an ID check), action_required or unknown. instructions is
the next step, for the user. Read it again after poll_after seconds, not sooner (each read asks the
exchange), until is_final.
- **list_currencies** — Find assets and their networks. Each id ('ticker:network') works as from_asset or to_asset. contract: the
token's address; extra_id_name: the asset uses a memo/tag.
- **list_providers** — The exchanges compared, with what each asks of a swap (email_required, refund_address_required...), kyc,
ip_shared, ip_kept and notice.

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://swaplume.com/developers), copied verbatim. Run them in order; they are not an mcpServers config.

1. Add to Claude Code:

```sh
claude mcp add --transport http swaplume https://api.swaplume.com/mcp
```

## Documentation

## What Swaplume does

Swaplume exposes crypto swap operations through a remote Model Context Protocol endpoint. It compares instant swap offers from nine exchanges, creates a swap with the selected provider, checks addresses, and reports the state of an existing swap. It also provides reference data for supported currencies, networks, and providers.

The service is useful when an agent needs to compare how much a user will receive before starting a swap. The selected exchange handles the transaction and custody; Swaplume never holds the user's funds.

## How it works

Connect an MCP client to `https://api.swaplume.com/mcp`. The service is free to use and does not require authentication.

A typical flow is:

1. Call `list_currencies` to find supported assets and networks. Use the returned currency ID, formatted as `ticker:network`, in later requests.
2. Call `get_quotes` to compare offers. Quotes are ordered best first. When requesting by the amount to receive, results are ordered by the amount the user must send.
3. Use the selected quote with `create_swap`. This creates the swap and returns the deposit address and any required memo or tag.
4. The user sends the requested source amount to that address, adding `deposit_extra_id` when supplied.
5. Call `get_swap` to follow progress until the swap reaches a final state.

Quotes include `amount_to`, which represents the amount received after fees. If no exchange can quote the requested amount, the response can include a usable range in `limits`. The `savings_pct` value compares the best and worst available offers. After receiving quotes, wait for the returned `refresh_after` interval before requesting them again.

## Tools and capabilities

- `get_quotes` compares offers from all available exchanges and reports exchange-specific errors, including amount limits when relevant.
- `create_swap` starts a swap and returns the deposit instructions. It does not transfer funds itself.
- `validate_address` checks a payout or refund address. It can return valid, invalid with a reason, or null when that network's address format is not checked. The response also identifies assets requiring a memo or tag.
- `get_swap` returns statuses such as waiting, confirming, exchanging, sending, finished, failed, refunding, refunded, expired, verifying, and action required. Its instructions field gives the next user step, and `poll_after` indicates when to read the status again.
- `list_currencies` lists assets, networks, token contract addresses, and memo or tag requirements.
- `list_providers` describes compared exchanges, including requirements, KYC information, IP handling, and notices.

## Setup and configuration

Use the hosted MCP endpoint directly:

`https://api.swaplume.com/mcp`

No API key or other authentication is required. Configure the endpoint in an MCP-compatible client that supports remote MCP connections. There are no required environment variables for the hosted service.

## Limitations and notes

The exchange list may not produce a quote for every asset pair or amount. When an exchange cannot quote, `get_quotes` reports the reason; amounts outside a provider's limits include its minimum or maximum. If every provider fails, use the broadest range in `limits` to choose another amount.

Address validation is not universal. A `null` result means the network format was not checked by the service, while `false` requires showing the returned reason and asking for another address. Some providers may require an email address, refund address, KYC, or other actions, which are surfaced by `list_providers` and the swap instructions.

Creating a swap only generates the exchange order and deposit instructions. Funds move when the user sends the source asset to the supplied deposit address. Continue polling `get_swap` only after its indicated interval, and stop when `is_final` is true.

_Full upstream README: https://allmcps.com/mcp/swaplume/readme_