# Swaplume

> Swaplume is a free MCP server for finance and payments. Compare live crypto swap rates across nine instant exchanges and create swaps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://swaplume.com/developers
- **MCP Registry name:** com.swaplume/mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

The server sits on top of the Swaplume swap API, which queries nine instant exchanges at once and returns every offer with the best one first. Amounts are shown as what the user receives after all fees, so offers can be compared directly.

Creating a swap returns a deposit address, a memo when one is needed, and plain-English instructions. The user sends coins from their own wallet; Swaplume says it never holds funds, because the exchange receives the deposit and pays out to the user's address. A swap moves through the statuses waiting, confirming, exchanging, sending and finished, and the agent polls until it is final.

Quotes can be floating (an estimate) or fixed for a short time, and an exact receive amount can be requested instead of a send amount. Each quote also says how likely the exchange is to ask for ID, whether it needs an email and whether it accepts a refund address. Limits are 60 requests a minute and 20 new swaps an hour per IP.

## Features

- **Multi-exchange quotes:** Returns offers from nine instant exchanges, best first, with reasons when an exchange cannot do the swap.
- **Fixed or floating rates:** A fixed rate locks the amount until the quote expires; floating rates are estimates.
- **Exact receive amount:** Request the amount the user should receive and get back how much to send.
- **Address validation:** Checks a wallet address for an asset and network before a swap is created.
- **Provider details:** Lists each exchange with its KYC level, email requirement and refund address support.
- **Swap status polling:** Reports live status, the payout transaction once sent and what to do next.

## Good for

- Let an AI agent find the cheapest route between two coins
- Check an address before sending funds to it
- Add swap quotes to a wallet or portfolio assistant
- Compare exchanges by KYC and refund address support
- Track a pending swap until it finishes

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.swaplume.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.swaplume.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.swaplume.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.swaplume.com/mcp"
    }
  }
}
```

## Tools

- `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. 
- `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.

## FAQ

### Do I need an API key?

No. The MCP server at https://api.swaplume.com/mcp uses streamable HTTP with no authentication, and the REST API needs no account either.

### Does Swaplume hold my funds?

The site says it never holds funds. You send coins to the deposit address from your own wallet, and the exchange pays out to your address.

### How is it free?

The exchanges pay Swaplume a commission on swaps, and that commission is already included in the quotes.

### What are the usage limits?

60 requests a minute and 20 new swaps an hour per IP address.

### How are assets named?

As a ticker plus a network, for example btc, usdt:trx or usdc:sol.

### Is Swaplume free?

Yes. Swaplume is free to use.

### How do I add Swaplume to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.swaplume.com/mcp

### What are the best alternatives to Swaplume?

The closest alternatives to Swaplume are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/swaplume
