TRDEFI Liquidity
Live non-custodial stablecoin liquidity: open USDC/USDT maker positions across Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain, plus an on-chain swap quote. Free, no key.
Hosted MCP Server
npx add-mcp 'https://yield.trdefi.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
TRDEFI Liquidity — MCP server
A remote, read-only Model Context Protocol server for the live TRDEFI non-custodial stablecoin liquidity catalogue.
Endpoint: https://yield.trdefi.com/mcp · Transport: Streamable HTTP · Credential: none
Add it to any MCP-capable client and the ten tools below appear. There is nothing to install and no
key to request. Nine are reads. The tenth, trdefi_fusion_submit, only forwards a signature the
caller already made - it never signs, never holds a key, and cannot move a token on its own.
This repository holds only the registry manifest (server.json). The server itself runs on the same
host as the public API it reads.
Tools
| Tool | Answers |
|---|---|
trdefi_stats | How much liquidity is open, across how many networks, and how much has settled over 1, 7 and 30 days |
trdefi_chains | Which networks are live, their engine addresses, and the tokens a position can be built from |
trdefi_positions | The open positions — filter by network and by pair |
trdefi_position_detail | One position, by its strategy hash |
trdefi_position_inventory | Whether a position can actually be filled - strategy balance, maker wallet balance, allowance, read from the chain |
trdefi_quote | A swap simulated on-chain against one position, at the current block |
trdefi_fusion_quote | A 1inch Fusion quote for a pair - the path for positions that answer "Strategy is gated" |
trdefi_fusion_prepare | The EIP-712 Fusion order to sign, with its typed data, extension and quote id |
trdefi_fusion_submit | Forwards an already-signed Fusion order to 1inch's relayer |
trdefi_badge | A shields.io payload, so a README can show live figures |
How a position is bound, and how the swap completes
A position is not a deposit and not a pool you join. The maker signs a bounded, revocable allowance: one token, one amount, one deadline. Nothing is deposited, nothing is locked, the capital never leaves the maker's wallet, and the exit is a single transaction.
An agent does not manage a position and does not need to work out what the maker's two tokens are. It asks for a position to trade against, gets a price for the swap it wants, and the engine settles the swap on its own once the swap is signed.
A maker may gate a position on the caller holding an access licence token, and on most networks
most of them do: measured 2026-10-19 across 17 networks, 62 percent answered "Strategy is gated"
and 17 percent returned a price. On Ethereum, 58 of 60 sampled positions are gated. The credential
contract is only deployed on the 13 Aqua chains, so Arc, Monad, Cronos and HyperEVM carry no such
gate. quote_ready narrows to positions on a network with a quote route, but it does not guarantee
a price.
Pass from to trdefi_quote with the address that will sign the swap. The gate is checked on
tx.origin: without a caller the API answers as address(0) and returns the least specific
revert available, 0x89c62b64. With one it returns 0x39c4052c, which names the actual problem.
A caller holding the maker's credential gets a real price; anyone else gets an accurate "you do
not hold it".
For the live counts, read trdefi_stats. They refresh on a timer, so nothing here hardcodes them.
What an agent can do with it
- Understand the liquidity landscape before proposing anything: which networks, which pairs, how deep
- Find a specific position and inspect it
- Price a swap, or learn why one cannot be priced — a maker may gate a position on the caller holding an access licence token, and those answer with that reason rather than a number
What it deliberately does not do
Creating a position and swapping are absent. Both return unsigned transactions and need a signing flow that has not been designed. Shipping a tool an agent cannot finish would only teach it that we are broken.
The underlying API is prepare-only in any case: it never signs, never broadcasts and never holds a key. Funds stay in the owner's wallet behind a bounded, revocable allowance.
Connecting
{
"mcpServers": {
"trdefi": {
"type": "streamable-http",
"url": "https://yield.trdefi.com/mcp"
}
}
}
Links
- API reference — https://yield.trdefi.com/docs/api
- OpenAPI 3.1 — https://yield.trdefi.com/openapi.json
- Agent index — https://yield.trdefi.com/llms.txt
- Live statistics — https://yield.trdefi.com/stats.html
Listings
- Official MCP Registry —
io.github.TRDEFI/liquidity - Glama — https://glama.ai/mcp/connectors/io.github.TRDEFI/liquidity
- Smithery — https://smithery.ai/server/@trdefi/liquidity
- mcpservers.org — https://mcpservers.org/servers/trdefi/mcp-server
- M8ven — https://m8ven.ai/mcp/trdefi-mcp-server-wq7ly5
- Coinbase x402 Bazaar — discoverable as a paid x402 service (the two prepare endpoints answer
402) - PayAPI Market — https://payapi.market/api/trdefi-liquidity
(listing live;
POST /v1/positionscarries a settled, verified payment — 0.02 USDC on Base, block 52475755) Agents can search it at https://payapi.market/mcp - Payforapi — https://payforapi.com/catalog/trdefi-liquidity-positions (both prepare endpoints listed; 402 verified live, 0.02 USDC on Base and Arc; cards in English and Russian) Machine-readable catalogue at https://payforapi.com/llms-full.txt
Registry
Published to the official MCP Registry as io.github.TRDEFI/liquidity.
License
All rights reserved.