paladinfi avatar

Paladin Swap

paladinfi/paladin-swap-mcp

A multi-aggregator swap router that queries 0x and Velora in parallel on Base and returns whichever delivers the higher post-fee buy amount. Exposes three MCP tools: swap_quote returns ready-to-execute calldata with slippage protection and a 10 bps affiliate fee already baked in, trust_check_preview runs a sample-fixture risk screen against OFAC/Goplus/Etherscan (the real paid endpoint costs $0.001 USDC per call via x402), and swap_health reports service liveness and per-source counters. Non-custodial, meaning your agent signs and submits every transaction. Reach for this when you need an agent to execute swaps without writing aggregator glue or slippage logic yourself.

tools
2
transport
HTTP
last updated
Apr 25, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

swap_quoteGet a competitive multi-aggregator swap quote with ready-to-execute calldata. PaladinFi does not represent any returned route as the best available across the broader DeFi market.6 params

Get a competitive multi-aggregator swap quote with ready-to-execute calldata. PaladinFi does not represent any returned route as the best available across the broader DeFi market.

Parameters* required
buyTokenstring
ERC20 contract address to buy (e.g. WETH on Base = 0x4200000000000000000000000000000000000006)
chainIdinteger
EVM chain ID (default 8453 = Base). Currently only Base is supported.default: 8453
sellAmountstring
Amount to sell in smallest unit (decimal string; e.g. "1000000000" = 1000 USDC)
sellTokenstring
ERC20 contract address to sell (e.g. USDC on Base = 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
slippageBpsvalue
Optional slippage tolerance in basis points (default from provider)
takerstring
Wallet address that will execute the swap (the agent's wallet)
swap_healthReturn the swap router's health + configuration (fee recipient, bps, supported chains).

Return the swap router's health + configuration (fee recipient, bps, supported chains).

No parameter schema in public metadata yet.

Sponsors

Readme

paladin-swap-mcp

Open client and API spec for PaladinFi Swap — a competitive multi-aggregator swap router for AI agents on Base. This repository contains the public REST and MCP API specification, working code examples, and thin client wrappers. The hosted backend at swap.paladinfi.com is proprietary.

Routing scope. PaladinFi Swap queries integrated upstream aggregators (currently 0x and Velora) in parallel and returns whichever delivers the higher post-fee buy amount. We do not represent any returned route as the best available, lowest-cost, or optimal across the broader DeFi market. Phrases like "best execution" are reserved-meaning terms in U.S. securities law and are deliberately not used here.


View the full README on GitHub

Details

Repository
github.com/paladinfi/paladin-swap-mcp
Website
paladinfi.com/swap
Transport
HTTP
Registry
MCP registry, active

More from paladinfi