# TRDEFI Liquidity

> Live non-custodial stablecoin liquidity: open positions, volume, and an on-chain swap quote.

- name: io.github.TRDEFI/liquidity
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 77/100 flags: no-repository
- quality: 72/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.TRDEFI%2Fliquidity
- tools: https://api.protogrid.dev/v1/servers/io.github.TRDEFI%2Fliquidity/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "liquidity": {
      "type": "http",
      "url": "https://yield.trdefi.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 35
- drivers: +reachable +uptime-100% +updated-25d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 72/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,371 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 20 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,371 tokens to load them all
- tool set hash: f2d7345e9e0ca8bbd2f2cf9b26624c7c
- tools last changed: 2026-10-20T04:21:45.169Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.TRDEFI/liquidity.svg)](https://protogrid.dev/servers/io.github.TRDEFI/liquidity)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-20 `trdefi_quote` changed (description, inputSchema)
  - before: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated" (revert 0x89c62b64), the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That is a property of the strategy, not a bug — pass `from` with an address that holds the token to simulate as that caller. Measured on 2026-10-12: about half of sampled positions are gated this way, and the split is strongly per-network — BNB Chain quotes cleanly, Ethereum and Base are almost entirely behind the gate. Quotes are simulated on 17 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain, hyperevm, cronos and robinhood-chain. This list is the set the quote path actually serves; if a network is not on it, do not promise a quote for it.
  - after: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated", the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That check reads tx.origin, so the revert depends on whether a caller was supplied: without one it is 0x89c62b64 ("the caller holds none"), with one it is 0x39c4052c (the tx-origin balance check). Pass `from` with the address that will actually sign the swap. A caller that holds the maker's credential gets a real price; anyone else gets an accurate "you do not hold it" instead of the least specific answer available. This is a property of the strategy, not a bug — and it is strongly per-network. Measured 2026-10-19: on Ethereum 58 of 60 sampled positions are gated, and across 17 networks the network-balanced split is about 62 percent gated and 17 percent priced. The credential contract itself is only deployed on the 13 Aqua chains, so Arc, Monad, Cronos and HyperEVM have no such gate. Quotes are simulated on 17 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain, hyperevm, cronos and robinhood-chain. This list is the set the quote path actually serves; if a network is not on it, do not promise a quote for it.
- 2026-10-20 `trdefi_positions` changed (description, inputSchema)
  - before: Live non-custodial liquidity, as positions an agent can actually trade against. Each row carries the strategy hash, network, pair, tokens, settled volume and a `quote_eligible` flag saying whether /api/quote can simulate it. Use this before a swap to find a real on-chain counterparty, or to survey where liquidity sits. Filter by network and by pair. Free, no key, no custody.
  - after: Live non-custodial liquidity, as positions an agent can actually trade against. Each row carries the strategy hash, network, pair, tokens, settled volume and a `quote_eligible` flag, meaning the position is router-attached and its network has a quote route. It does NOT mean the position will quote: a maker can still gate it. Use this before a swap to find a real on-chain counterparty, or to survey where liquidity sits. Filter by network and by pair. Free, no key, no custody.
- 2026-10-14 `trdefi_quote` changed (description)
  - before: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated" (revert 0x89c62b64), the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That is a property of the strategy, not a bug — pass `from` with an address that holds the token to simulate as that caller. Measured on 2026-10-12: about half of sampled positions are gated this way, and the split is strongly per-network — BNB Chain quotes cleanly, Ethereum and Base are almost entirely behind the gate. Quotes are simulated on 15 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain and hyperevm.
  - after: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated" (revert 0x89c62b64), the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That is a property of the strategy, not a bug — pass `from` with an address that holds the token to simulate as that caller. Measured on 2026-10-12: about half of sampled positions are gated this way, and the split is strongly per-network — BNB Chain quotes cleanly, Ethereum and Base are almost entirely behind the gate. Quotes are simulated on 17 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain, hyperevm, cronos and robinhood-chain. This list is the set the quote path actually serves; if a network is not on it, do not promise a quote for it.
- 2026-10-12 `trdefi_quote` changed (description) **meaning changed**
  - before: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. Note that a maker may gate a position on the caller holding an access licence token, and roughly four in five do — those answer with a clear reason instead of a price, which is a property of the maker's strategy rather than an error. A position on a network with no quote path is refused by name: quotes are only simulated on ethereum, base, arbitrum, optimism and polygon.
  - after: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated" (revert 0x89c62b64), the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That is a property of the strategy, not a bug — pass `from` with an address that holds the token to simulate as that caller. Measured on 2026-10-12: about half of sampled positions are gated this way, and the split is strongly per-network — BNB Chain quotes cleanly, Ethereum and Base are almost entirely behind the gate. Quotes are simulated on 15 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain and hyperevm.
- 2026-10-11 `trdefi_quote` changed (description)
  - before: Price a stablecoin swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Use this to check USDC/USDT liquidity and get the output amount before preparing a swap. Note that a maker may gate a position on the caller holding an access licence token, and roughly four in five do — those answer with a clear reason instead of a price, which is a property of the maker's strategy rather than an error.
  - after: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. Note that a maker may gate a position on the caller holding an access licence token, and roughly four in five do — those answer with a clear reason instead of a price, which is a property of the maker's strategy rather than an error. A position on a network with no quote path is refused by name: quotes are only simulated on ethereum, base, arbitrum, optimism and polygon.
- 2026-10-11 `trdefi_positions` changed (description, inputSchema)
  - before: Live non-custodial stablecoin liquidity, as positions an agent can actually trade against. Earn-worthy USDC/USDT maker positions: each row carries the strategy hash, network, pair, tokens and settled volume. Use this before a stablecoin swap to find a real on-chain counterparty, or to survey where stablecoin liquidity sits. Filter by network and by pair. Free, no key, no custody.
  - after: Live non-custodial liquidity, as positions an agent can actually trade against. Each row carries the strategy hash, network, pair, tokens, settled volume and a `quote_eligible` flag saying whether /api/quote can simulate it. Use this before a swap to find a real on-chain counterparty, or to survey where liquidity sits. Filter by network and by pair. Free, no key, no custody.
- 2026-10-01 `trdefi_badge` changed (title)
- 2026-10-01 `trdefi_quote` changed (title)
- 2026-10-01 `trdefi_position_detail` changed (title)
- 2026-10-01 `trdefi_positions` changed (title)

Full history: https://api.protogrid.dev/v1/servers/io.github.TRDEFI%2Fliquidity/changes

## Remotes

- https://yield.trdefi.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `trdefi_badge`: A shields.io endpoint payload for the catalogue metrics, so a README can show live figures. Metrics: volume30, volume7, volume1, strategies, makers, pairs, chains.
- `trdefi_chains`: The networks where liquidity is live right now, with each network's settlement engine address and the tokens a position can be built from. Use this instead of hardcoding chain or token identifiers.
- `trdefi_position_detail`: One position in full, by its 32-byte strategy hash.
- `trdefi_positions`: Live non-custodial liquidity, as positions an agent can actually trade against. Each row carries the strategy hash, network, pair, tokens, settled volume and a `quote_eligible` flag, meaning the position is router-attached and its network has a quote route. It does NOT mean the position will quote: a maker can still gate it. Use this before a swap to find a real on-chain counterparty, or to survey where liquidity sits. Filter by network and by pair. Free, no key, no custody.
- `trdefi_quote`: Price a swap against one position, on-chain, at the current block — no custody, nothing signed, nothing moved. Works on any pair the position trades, not only stablecoins. Use this to check liquidity and get the output amount before preparing a swap. If a position answers "Strategy is gated", the maker embedded an access-licence check in the order: the CALLER must hold the 1inch Aqua access token. That check reads tx.origin, so the revert depends on whether a caller was supplied: without one it is 0x89c62b64 ("the caller holds none"), with one it is 0x39c4052c (the tx-origin balance check). Pass `from` with the address that will actually sign the swap. A caller that holds the maker's credential gets a real price; anyone else gets an accurate "you do not hold it" instead of the least specific answer available. This is a property of the strategy, not a bug — and it is strongly per-network. Measured 2026-10-19: on Ethereum 58 of 60 sampled positions are gated, and across 17 networks the network-balanced split is about 62 percent gated and 17 percent priced. The credential contract itself is only deployed on the 13 Aqua chains, so Arc, Monad, Cronos and HyperEVM have no such gate. Quotes are simulated on 17 networks: ethereum, base, arbitrum, optimism, polygon, arc, bnb-chain, gnosis, avalanche, sonic, linea, zksync-era, monad, unichain, hyperevm, cronos and robinhood-chain. This list is the set the quote path actually serves; if a network is not on it, do not promise a quote for it.
- `trdefi_stats`: Aggregate statistics for the live TRDEFI non-custodial stablecoin liquidity catalogue: how many open maker positions exist, how many distinct makers, how many pairs, across how many networks, plus settled volume over 1, 7 and 30 days, and the deepest pairs by volume and by position count. Free, no key.