Multi-aggregator swap router for AI agents on Base. 10 bps fee. MCP-native, non-custodial.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-paladinfi-paladin-swap": {
"command": "<see-readme>",
"args": []
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Multi-aggregator swap router for AI agents on Base. 10 bps fee. MCP-native, non-custodial.
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationBe the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ai-ml
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
The official Python SDK for Model Context Protocol servers and clients
MCP Security Weekly
Get CVE alerts and security updates for io.github.paladinfi/paladin-swap and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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 a limited set of integrated upstream aggregators (currently 0x Settler; 1inch and Odos planned) and returns a competitive route. 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.
A swap router built for AI agents that need to execute on-chain swaps. Your agent calls a single tool; the service returns ready-to-execute calldata your wallet signs and submits:
Agents skip writing aggregator glue, slippage handling, and fee logic. One call, ready bytes.
The Service is non-custodial: PaladinFi never holds, signs, or moves user funds. Every transaction is signed and submitted by the user's own wallet (or their agent acting on their behalf).
For Claude Code or any MCP-compatible client supporting Streamable-HTTP transport:
claude mcp add --transport http --scope user paladin-swap https://swap.paladinfi.com/mcp
Restart your client. Two tools become available:
swap_quote(sellToken, buyToken, sellAmount, taker, chainId?, slippageBps?)swap_health()See mcp-tools.json for the full tool schemas.
No MCP needed — hit the endpoint directly:
curl -sS https://swap.paladinfi.com/v1/quote \
-H 'content-type: application/json' \
-d '{
"chainId": 8453,
"sellToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"buyToken": "0x4200000000000000000000000000000000000006",
"sellAmount": "5000000",
"taker": "0xYOUR_AGENT_WALLET"
}'
Full REST spec in openapi.yaml.
| Method | Path | Purpose |
|---|---|---|
GET | /health | Liveness + fee config |
POST | /v1/quote | Competitive route quote with calldata |
POST | /mcp | MCP Streamable-HTTP transport |
{
"source": "0x",
"chainId": 8453,
"router": "0x0000000000001ff3684f28c67538d4d072c22734",
"calldata": "0x...",
"buyAmount": "2160000000000000",
"minBuyAmount": "2138000000000000",
"sellAmount": "5000000",
"gas": "318707",
"ourFeeBps": 10,
"ourFeeRecipient": "0xeA8C33d018760D034384e92D1B2a7cf0338834b4",
"estimatedOurFeeAmount": "2160000000000",
"estimatedOurFeeToken": "0x4200000000000000000000000000000000000006"
}
Submit the transaction as to=router, data=calldata, value=0 (for ERC20→ERC20) from taker.
examples/python/quote_and_swap.py — Python with web3.pyexamples/typescript/quote_and_swap.ts — TypeScript with viemA flat 10 basis points (0.1%) is taken on the *buy token