Swap API

io.github.Swap-APIPublished by GitHub account Swap-APIv0.1.0Updated Oct 24, 2026

MCP server for SwapAPI - get executable token swap calldata for EVM chains

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

Local MCP server that gives an assistant executable token swap calldata for EVM chains via SwapAPI, with one swap_tokens tool.

What you can do
  • Get executable swap transaction data (router address, calldata, native value, gas estimate, minimum output) for a token pair on a given EVM chain
  • Specify chain ID, input and output token addresses, amount in smallest units, sender wallet and optional slippage tolerance (default 0.5%)
  • Use the native-token placeholder address for swaps from or to ETH, MATIC and similar
  • Returns calldata only; the assistant or user still signs, approves and submits the transaction
When to use it
Useful when an agent needs to prepare token swaps on EVM chains such as Ethereum, Base or Arbitrum and hand back ready-to-sign transaction data, for example inside a trading or DeFi workflow. Not needed if you only want quotes or if you do not intend to submit on-chain transactions.
Requirements
Runs locally over stdio, installed from the npm package @swapapi/mcp (Node.js/npx) and configured in an MCP client such as Claude Desktop or Cursor. No environment variables, headers or authentication are declared; network access to the SwapAPI service is implied.
Before you install
The output is live transaction data for moving real funds: the sender wallet address is sent to the SwapAPI service, and calldata expires, so quotes must be submitted quickly. The README's pre-flight checklist warns to verify ERC-20 approval, balance, gas estimate and simulation before submitting. Slippage tolerance affects the guaranteed minimum output. The server itself does not sign or send transactions.

Installation

In SourceWeft

  1. Open Swap API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

SwapAPI MCP Server

MCP (Model Context Protocol) server for SwapAPI. Enables AI agents to get executable token swap calldata for any EVM chain.

Installation

bash
npm install -g @swapapi/mcp

Or use directly with npx:

bash
npx @swapapi/mcp

Client Configuration

Claude Desktop

Add to your Claude Desktop config:

json
{  "mcpServers": {    "swapapi": {      "command": "npx",      "args": ["@swapapi/mcp"]    }  }}

Or with a local install:

json
{  "mcpServers": {    "swapapi": {      "command": "npx",      "args": ["tsx", "/path/to/swap-api/mcp/mcp-server.ts"]    }  }}

Cursor

Add to your Cursor settings (Settings → MCP):

json
{  "mcpServers": {    "swapapi": {      "command": "npx",      "args": ["@swapapi/mcp"]    }  }}

Other Clients

Any MCP-compatible client can use the same configuration format. Check your client's documentation for where to add MCP server settings.

Available Tools

swap_tokens

Get executable transaction data to swap tokens on EVM chains.

Parameters:

ParameterTypeRequiredDescription
chainIdnumberYesChain ID (1=Ethereum, 8453=Base, 42161=Arbitrum, etc.)
tokenInstringYesInput token address. Use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native token (ETH, MATIC, etc.)
tokenOutstringYesOutput token address
amountInstringYesAmount in smallest unit (wei for 18-decimal tokens, micro-units for 6-decimal tokens)
senderstringYesWallet address that will sign and send the transaction
maxSlippagenumberNoMax slippage tolerance 0-1 (default: 0.005 = 0.5%)

Returns:

json
{  "to": "0x...",           // Router contract address to call  "data": "0x...",         // ABI-encoded swap calldata  "value": "1000000000000000000",  // Native token value (if swapping from native)  "gas": "150000",         // Estimated gas limit  "guaranteedOut": "..."   // Minimum output amount after slippage}

Examples

Swap 0.001 ETH to USDC on Base

json
{  "chainId": 8453,  "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  "tokenOut": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",  "amountIn": "1000000000000000",  "sender": "0xYourAddress"}

Swap USDC to ETH on Arbitrum with 1% slippage

json
{  "chainId": 42161,  "tokenIn": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",  "tokenOut": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  "amountIn": "10000000",  "sender": "0xYourAddress",  "maxSlippage": 0.01}

Pre-flight Checklist

Before submitting any swap transaction:

  1. ERC-20 Approval: If tokenIn is not native token, ensure sender has approved the router for at least amountIn
  2. Balance Check: Verify sender has sufficient balance for amountIn (plus value if native token)
  3. Gas Estimation: Call eth_estimateGas on the transaction and add 20% buffer
  4. Simulation: Run eth_call to verify the transaction won't revert
  5. Timing: Submit within 30 seconds of fetching the quote (calldata has expiry)

See the main README.md for full API documentation.

Development

bash
cd mcpnpm installnpm start

Testing

Run the test suite:

bash
npm test

Or use the MCP Inspector:

bash
npx @modelcontextprotocol/inspector tsx mcp-server.ts

License

MIT

Source: mcp/README.md at commit bdfd033

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts