Servidor MCP

loomdesk

trade.loomdesk/loomdesk
Cripto y Web3 Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este MCP

Analyzes tokenized stock liquidity pools and generates unsigned transactions for positions, ladders, pool openings, fee collection, and withdrawals.

book_status
The LoomDesk book
The protocol-owned liquidity book: value, positions, fees collected, earnings waiting for the daily 18:00 UTC payout, and what has been paid to LOOM holders.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_pool
One pool in full
Everything list_pools knows about one pool plus its v4 pool key, by symbol (LoomDesk's own pool of that stock if there is one, else the deepest) or by pool id.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pool'], 'properties': {'pool': {'type': 'string', 'minLength': 1, 'description': 'A stock symbol such as META, or a pool id / address'}}}
ladder_pools
The pools of a token a ladder can be built in
For one token: the pools a ladder can go in, in the order the site offers them (real markets that pay their liquidity first; then real markets whose launchpad hook keeps the whole fee, where a ladder is only a grid of orders; then small ones). Each with swap fee, whether it pays liquidity, depth, 24h volume and fees, and fees as a share of liquidity per week. The first is the default.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token'], 'properties': {'quote': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'ETH, USDG or an address: the pair asked about; the answer then says whether that exact pair has a pool, or that plan_build opens one'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}}
list_pools
List stock/USDG pools
Tokenized stock pools on Robinhood Chain with what a dollar of liquidity earned in them (weekly rate at ±5/10/15/25% ranges), how much of those fees the pool kept after arbitrage (keep), depth, and 24h flow. LoomDesk's own pools are marked own: true; those are the pools Earn opens positions in, and the ones a tenth of whose swap fees pay the LoomDesk book. Rates are measurements of the past week, not forecasts.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sort': {'enum': ['net_weekly', 'weekly_at_10', 'depth', 'fees_24h'], 'type': 'string', 'default': 'net_weekly'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1}, 'own_only': {'type': 'boolean', 'default': True, 'description': "Only LoomDesk's own pools (default). false lists every stock pool on the chain."}, 'min_depth_usdg': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Skip pools shallower than this.'}}}
market_tokens
What trades on Robinhood Chain
Every token that traded in the last day, from LoomDesk's own index of every swap on the chain: price, market cap, 24h volume, fees, trades, depth, age, tier (established / new / untested) and keep (the share of its fees the busiest pool kept after the price moved). Flagged tokens (a stranger cannot sell them, or they tax transfers) are left out. `query` searches by symbol, name or address. `leadersWindowSeconds` instead returns the most traded and highest volume tokens over that window (300 to 604800).
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 64}, 'leadersWindowSeconds': {'type': 'integer', 'maximum': 604800, 'minimum': 300}}}
my_ladders
A wallet's ladders and what it has done
Every live ladder of a wallet (on the current LoomLadder and earlier ones): pair, rungs with what each holds and which side of the price it is on, value, fees waiting (after LoomDesk's share), fees already collected, PnL against simply holding what went in, and the wallet's history of opens, collects, partial withdraws and closes. A ladder that is a limit order (opened with one asset, never re-laid) carries `limitOrder`: its side, what it holds at this moment and how much of it stands filled (a part fill is undone when the price turns back), the most it has been filled, and whether it is closed once filled.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}}
my_positions
A wallet's Earn positions
The Uniswap v4 positions a wallet opened through LoomDesk Earn: pool, range, whether in range, value and uncollected fees.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'The wallet address'}}}
plan_build
One transaction from ETH or USDG to a ladder, the pool opened on the way
One transaction (two when paying in USDG: its approval first) from ETH or USDG to a ladder in a v4 pool of the token against the quote (ETH, USDG, LOOM, a stock, a memecoin with an exit). The pool is opened on LoomDesk's hook inside the same transaction when the pair has none (feePct 1 to 5, about a dollar); the sides the wallet's asset is not are bought through Nordstern inside it, split by the band; the pool's fee is paid from it; the ladder is built for the owner; leftovers come back. Prefer it over plan_swap + plan_open_pool + plan_ladder whenever the caller pays in ETH or USDG.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token', 'quote', 'payIn', 'amount', 'owner'], 'properties': {'pool': {'type': 'string', 'description': "A v4 pool of the token to build in, by id from ladder_pools: any pool, on the hook or not; the quote is then that pool's"}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'payIn': {'enum': ['ETH', 'USDG'], 'type': 'string'}, 'quote': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': "ETH, USDG, or the quote token's address"}, 'rungs': {'type': 'integer', 'maximum': 40, 'minimum': 1}, 'shape': {'enum': ['spot', 'curve', 'bidask', 'hybrid'], 'type': 'string'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d*\\.?\\d+$'}, 'copyOf': {'type': 'string', 'pattern': '^\\d+$'}, 'feePct': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'lowPct': {'type': 'number', 'maximum': 400, 'minimum': -98, 'description': 'needed unless fullRange'}, 'highPct': {'type': 'number', 'maximum': 500, 'minimum': -97}, 'referrer': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'fullRange': {'type': 'boolean'}, 'slippagePct': {'type': 'number', 'maximum': 50, 'minimum': 0.5}}}
plan_ladder
Plan a ladder and get the transactions to sign
For a wallet that already holds the assets it brings; from ETH or USDG, plan_build does the whole thing in one transaction. A ladder is one deposit spread over up to 40 narrow one-sided ranges ('rungs') of a Uniswap v3 or v4 pool: rungs under the price hold the quote asset (ETH, WETH, USDG or LOOM) and buy the token as it falls, rungs over the price hold the token and sell it as it rises, and rungs the price trades through earn the pool's swap fee. Give the band as percent from the current price (lowPct negative for under the price), the amounts as decimal strings, and the owner wallet. With one asset only, `split: true` swaps part of it for the other in the same pool and builds the whole band in one transaction (the minimum out comes from the chain's quoter, hook taxes included). Returns the unsigned transactions (approvals if needed, then the open or the zap) laid out from the pool's price on the chain right now. You sign and send them from the owner wallet; nothing is signed or sent here. Fees: 0.25% of what goes in, taken out of the rungs as they are minted (0.1% of it to `referrer` when given, 0.1% to the owner of the ladder `copyOf` names while it is open in the same pair); then 5% of the trading fees the ladder earns, nothing of a gain when liquidity is taken out, and 5% of the ladder's value when the NFTs are taken out instead; 3.5% for an owner holding 100,000 LOOM. Every cut is paid as USDG, with a slice of the token sold in the same pool when the money side is short.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token', 'owner', 'lowPct', 'highPct'], 'properties': {'pool': {'type': 'string', 'description': 'A pool from ladder_pools; the default pool when left out'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'rungs': {'type': 'integer', 'maximum': 40, 'minimum': 1}, 'shape': {'enum': ['spot', 'curve', 'bidask', 'hybrid'], 'type': 'string'}, 'split': {'type': 'boolean'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'copyOf': {'type': 'string', 'pattern': '^\\d+$', 'description': 'The id of a ladder on the current contract this one copies: its owner is paid 0.1% while it is open in the same pair.'}, 'lowPct': {'type': 'number', 'maximum': 400, 'minimum': -98}, 'highPct': {'type': 'number', 'maximum': 500, 'minimum': -97}, 'newPool': {'type': 'object', 'required': ['key', 'sqrtPriceX96'], 'properties': {'key': {'type': 'object', 'required': ['currency0', 'currency1', 'fee', 'tickSpacing', 'hooks'], 'properties': {'fee': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'hooks': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'currency0': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'currency1': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'tickSpacing': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}}, 'sqrtPriceX96': {'type': 'string', 'pattern': '^\\d+$'}}, 'description': "From plan_open_pool's `then`, for a pool being opened in the same plan: the ladder is laid out against its key and opening price. No split in it (it is empty): both amounts, or one for a one-sided ladder."}, 'referrer': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': "The wallet that referred the owner: paid 0.1% of what goes in, out of the opening fee, and kept by the contract from the owner's first ladder on."}, 'fullRange': {'type': 'boolean', 'description': 'One position across every price instead of a band of rungs. Never out of range and needs no watching; very little of the money sits at the price, so it earns the least per dollar. Needs both amounts, or one amount with split: true. lowPct and highPct are ignored.'}, 'payWithEth': {'type': 'boolean', 'description': 'For a pool quoted in WETH: pay in plain ETH, wrapped inside the same transaction, with nothing to approve. Default: whenever the wallet holds less WETH than amountQuote.'}, 'amountQuote': {'type': 'string', 'pattern': '^\\d*\\.?\\d+$'}, 'amountToken': {'type': 'string', 'pattern': '^\\d*\\.?\\d+$'}, 'slippagePct': {'type': 'number', 'maximum': 50, 'minimum': 0.1}}}
plan_ladder_action
Collect, partly withdraw, close or take out a ladder
The unsigned transaction for one of a ladder's exits, or for a limit order's rule. collect: pays the fees earned and leaves the ladder working. close_part: takes sharePct of every rung out, the rest keeps working. close: pays the fees and returns everything; it is also how a limit order is cancelled (a ladder opened before 30 September 2026 pays a share of a gain: the answer's gainCut). take_nfts: hands the Uniswap position NFTs to the owner; it always works, even when new ladders are paused. close and close_part are simulated first and carry minimums from slippagePct. close_once_filled: for a limit order, sets (on, the default) or clears the rule that has the keeper close it once the price has passed all the way through it and pay what it holds as it is; refused on an order that is filled already (close it), and it adds a deposit to the owner's gas tank when that does not cover one close.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ladderId', 'owner', 'action'], 'properties': {'on': {'type': 'boolean', 'description': 'close_once_filled only: false clears the rule'}, 'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Where the proceeds go; the owner when left out'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'action': {'enum': ['collect', 'close_part', 'close', 'take_nfts', 'close_once_filled'], 'type': 'string'}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'The LoomLadder the ladder lives in, from my_ladders; the current one when left out'}, 'ladderId': {'type': 'string', 'pattern': '^\\d+$'}, 'sharePct': {'type': 'number', 'maximum': 99, 'minimum': 1}, 'slippagePct': {'type': 'number', 'maximum': 50, 'minimum': 0.01}}}
plan_limit_order
Place a limit buy or a limit sell
An order at a price: a limit sell holds the token in rungs over the price and sells it as the price rises through them; a limit buy holds the quote under the price and buys as it falls. Placed now in one transaction, nothing is swapped, and it earns the pool's fee while it fills. One price is one rung, one step of the pool wide (2% in a 1% pool, up to 22% in a 10% pool); priceTo makes it a range of up to 40 rungs. Prices are built on the pool's steps: when that moves them more than 1% the plan is refused with the built prices, until they are asked for or acceptBuilt is set. A part fill is not final: the rungs trade back if the price turns before the order is complete. closeOnceFilled (the default) has the keeper close it once the price has passed all the way through and pay what it holds as it is, from the owner's gas tank. Closing an order early while its token is worth more than when it was placed pays the usual share of that gain. Returns the unsigned transactions.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token', 'owner', 'side', 'price', 'amount'], 'properties': {'pool': {'type': 'string', 'description': 'A pool from ladder_pools; the default pool when left out'}, 'side': {'enum': ['buy', 'sell'], 'type': 'string'}, 'unit': {'enum': ['usd', 'quote'], 'type': 'string'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'price': {'type': 'number', 'description': 'The limit price: dollars a token, or the pool\'s quote asset a token with unit "quote". A sell\'s is over the price now, a buy\'s under it.', 'exclusiveMinimum': 0}, 'rungs': {'type': 'integer', 'maximum': 40, 'minimum': 1, 'description': 'A range only; 5 when left out'}, 'shape': {'enum': ['spot', 'curve', 'bidask'], 'type': 'string', 'description': 'A range only. spot: even; curve: more where the order starts; bidask: more where it is complete'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d*\\.?\\d+$', 'description': 'Of the asset the order holds, as a decimal string: the token for a sell, the quote for a buy'}, 'copyOf': {'type': 'string', 'pattern': '^\\d+$'}, 'priceTo': {'type': 'number', 'description': 'Where the order is complete, further from the price than `price`. Left out: one rung, the narrowest the pool has.', 'exclusiveMinimum': 0}, 'referrer': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'payWithEth': {'type': 'boolean', 'description': 'A limit buy in a pool quoted in WETH: pay in plain ETH, wrapped inside the same transaction. Default: whenever the wallet holds less WETH than the amount.'}, 'acceptBuilt': {'type': 'boolean', 'description': 'Place it at the prices the pool can hold, however far they lie from the prices asked for'}, 'closeOnceFilled': {'type': 'boolean', 'description': "Default true: the plan's `then` says how to set the rule once the order is placed"}}}
plan_open_pool
Open a pool that pays its liquidity
When a token has no pool against the quote wanted (ladder_pools shows none, or none that pays liquidity): plan a new Uniswap v4 pool for it on LoomDesk's open hook, with a flat 1% or 3% swap fee: nine tenths to liquidity providers, one tenth to the LoomDesk book. The quote can be ETH, USDG, a tokenized stock, LOOM, or any token with a real exit (2,000 USDG of liquidity on the chain and a route to USDG): LOOM/PONS, a memecoin against a memecoin. One-off cost about a dollar (1 USDG or 0.0004 ETH), paid by the owner. It opens at the price of the token's existing market. Expect its flow to be mostly arbitrage plus what routers send; a new pool starts with neither. The pool holds nothing until a ladder is built in it: the result's `then` carries the pool id and key for plan_ladder (with newPool), so the pool and the ladder can be planned together and signed in order.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token', 'quote', 'feePct', 'owner'], 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'quote': {'anyOf': [{'enum': ['ETH', 'USDG'], 'type': 'string'}, {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}], 'description': '"ETH", "USDG", or the address of the quote token: a tokenized stock, LOOM, or any token with an exit'}, 'token': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'feePct': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': "the pool's swap fee in percent: 1, 2, 3, 4 or 5"}}}
plan_swap
Buy a side a plan needs, through Nordstern
The unsigned transactions for a swap on the chain through Nordstern's aggregator (an approval of the router when paying with a token, then the route), with what it returns and the least it may. For a pair the caller wants but only holds ETH or USDG for: one plan_swap per missing side, then plan_ladder with to.atLeast as that side's amount. Nothing is signed here.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['from', 'to', 'amount', 'owner'], 'properties': {'to': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'ETH, USDG, a token symbol or address'}, 'from': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'ETH, USDG, a token symbol or address'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d*\\.?\\d+$', 'description': 'how much of `from`, as a decimal string'}, 'slippagePct': {'type': 'number', 'maximum': 50, 'minimum': 0.1}}}
quote_position
Quote a position and build the transactions that open it
For an amount of USDG and a range around the current price in one of LoomDesk's own pools: the 1% fee to open, the stock the desk would buy, the ticks, what the position would have earned per week at the pool's measured rate, and the two transactions (USDG approve, EarnDeskV4.open) that open it, minted to the sender's wallet. Nothing is sent: the caller signs and sends them from its own wallet within 20 minutes. Keep a deposit under maxSensibleDepositUsdg: in a shallow pool a larger buy of the stock side moves the price against you.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pool', 'usdg'], 'properties': {'pool': {'type': 'string', 'minLength': 1, 'description': 'Symbol or pool id of a LoomDesk pool'}, 'usdg': {'type': 'number', 'description': 'USDG to put in, fee included, e.g. 250', 'exclusiveMinimum': 0}, 'range_pct': {'type': 'number', 'default': 5, 'maximum': 50, 'minimum': 0.5, 'description': 'Half-width of the range around the current price, in percent'}}}
Modificado
plan_ladder_action
1 de October de 2026 a las 02:43
Modificado
my_ladders
1 de October de 2026 a las 02:43
Añadido
plan_limit_order
1 de October de 2026 a las 02:43
Modificado
plan_ladder
1 de October de 2026 a las 02:43
Modificado
plan_build
27 de September de 2026 a las 02:43
Modificado
plan_ladder
27 de September de 2026 a las 02:43
Añadido
plan_swap
25 de September de 2026 a las 02:50
Añadido
plan_build
25 de September de 2026 a las 02:50
Modificado
plan_open_pool
25 de September de 2026 a las 02:50
Modificado
plan_ladder
25 de September de 2026 a las 02:50
Modificado
ladder_pools
25 de September de 2026 a las 02:50
Modificado
plan_open_pool
23 de September de 2026 a las 02:41
Modificado
plan_ladder
23 de September de 2026 a las 02:41
Añadido
plan_open_pool
21 de September de 2026 a las 02:49
Añadido
plan_ladder_action
21 de September de 2026 a las 02:49
Añadido
my_ladders
21 de September de 2026 a las 02:49
Añadido
plan_ladder
21 de September de 2026 a las 02:49
Añadido
ladder_pools
21 de September de 2026 a las 02:49
Añadido
market_tokens
21 de September de 2026 a las 02:49
Añadido
my_positions
19 de September de 2026 a las 02:40
Añadido
book_status
19 de September de 2026 a las 02:40
Añadido
quote_position
19 de September de 2026 a las 02:40
Añadido
get_pool
19 de September de 2026 a las 02:40
Añadido
list_pools
19 de September de 2026 a las 02:40