Servidor MCP

AgentData - Executable Liquidity / Exit-Cost

io.github.phenicea/agentdata-liquidity-exit-cost
Cripto y Web3 Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este MCP

Estimates token exit costs, price impact, liquidity fragility, best routes, and depeg risk using Base on-chain AMM data.

liquidity_exit_cost
Size-aware exit cost, depeg risk, and liquidity fragility for a token on Base. Given a token and a sell size, returns the realized cost of exiting (price impact + fee, in bps and units), the best route across venues, an aggregated fragility score, and — for pegged assets — a depeg-risk score. Computed deterministically from on-chain AMM state, so the result is reproducible and auditable. Three tiers by compute depth (default 'risk'): 'quote' = best-route exit cost for one size; 'risk' = exit cost + fragility (+ depeg for pegged tokens); 'deep' = adds a multi-size exit-cost curve, max-size-before-cost thresholds, and an internal cross-check. Pricing per call (USDC): quote = $0, risk = $0, deep = $0. Status: testnet/preview — payment runs over the x402 HTTP surface, not this tool.
Esquema de entrada
{'type': 'object', 'title': 'liquidity_exit_costArguments', 'required': ['token', 'size'], 'properties': {'pool': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Pool', 'default': None, 'description': 'Optional: restrict the computation to a single pool id.'}, 'size': {'type': 'number', 'title': 'Size', 'description': 'Sell size in human token units (> 0).', 'exclusiveMinimum': 0}, 'tier': {'enum': ['quote', 'risk', 'deep'], 'type': 'string', 'title': 'Tier', 'default': 'risk', 'description': "Pricing/compute tier. 'quote' = best-route exit cost only; 'risk' (default) adds fragility + depeg; 'deep' adds a multi-size exit-cost curve and cross-check."}, 'token': {'type': 'string', 'title': 'Token', 'description': "Token symbol/address to exit (sell), e.g. 'WETH'."}}}
Esquema de salida
{'type': 'object', '$defs': {'CrossCheck': {'type': 'object', 'title': 'CrossCheck', 'required': ['deepest_pool_id', 'deepest_pool_cost_bps', 'best_route_cost_bps'], 'properties': {'deepest_pool_id': {'type': 'string', 'title': 'Deepest Pool Id'}, 'best_route_cost_bps': {'type': 'number', 'title': 'Best Route Cost Bps'}, 'deepest_pool_cost_bps': {'type': 'number', 'title': 'Deepest Pool Cost Bps'}}}, 'CurvePoint': {'type': 'object', 'title': 'CurvePoint', 'required': ['size', 'amount_out', 'mid_price', 'exec_price', 'total_cost_bps', 'price_impact_bps', 'fee_bps', 'size_multiple'], 'properties': {'size': {'type': 'number', 'title': 'Size', 'description': 'Sell size in human token units.'}, 'fee_bps': {'type': 'number', 'title': 'Fee Bps', 'description': 'Pool fee component, bps.'}, 'mid_price': {'type': 'number', 'title': 'Mid Price', 'description': 'Marginal price (out per 1 in) at size 0.'}, 'amount_out': {'type': 'number', 'title': 'Amount Out', 'description': 'Output-token units received (fee incl.).'}, 'exec_price': {'type': 'number', 'title': 'Exec Price', 'description': 'Realized price = amount_out / size.'}, 'size_multiple': {'type': 'number', 'title': 'Size Multiple'}, 'total_cost_bps': {'type': 'number', 'title': 'Total Cost Bps', 'description': 'Loss vs mid (fee + slippage), bps.'}, 'price_impact_bps': {'type': 'number', 'title': 'Price Impact Bps', 'description': 'Slippage only (fee excluded), bps.'}}}, 'DepegModel': {'type': 'object', 'title': 'DepegModel', 'required': ['deviation_bps', 'dispersion_bps', 'weighted_price', 'total_liquidity', 'score'], 'properties': {'score': {'type': 'number', 'title': 'Score', 'description': '0..100, higher = more depeg risk.'}, 'deviation_bps': {'type': 'number', 'title': 'Deviation Bps'}, 'dispersion_bps': {'type': 'number', 'title': 'Dispersion Bps'}, 'weighted_price': {'type': 'number', 'title': 'Weighted Price'}, 'total_liquidity': {'type': 'number', 'title': 'Total Liquidity'}}}, 'RouteModel': {'type': 'object', 'title': 'RouteModel', 'required': ['best', 'pool_id', 'dex', 'routed_split', 'venues_considered'], 'properties': {'dex': {'type': 'string', 'title': 'Dex'}, 'best': {'$ref': '#/$defs/ExitCostModel'}, 'pool_id': {'type': 'string', 'title': 'Pool Id'}, 'routed_split': {'type': 'boolean', 'title': 'Routed Split', 'description': 'True if cost is split across venues.'}, 'venues_considered': {'type': 'integer', 'title': 'Venues Considered'}}}, 'MaxSizeEntry': {'type': 'object', 'title': 'MaxSizeEntry', 'required': ['max_cost_bps', 'max_size'], 'properties': {'max_size': {'type': 'number', 'title': 'Max Size'}, 'max_cost_bps': {'type': 'number', 'title': 'Max Cost Bps'}}}, 'ExitCostModel': {'type': 'object', 'title': 'ExitCostModel', 'required': ['size', 'amount_out', 'mid_price', 'exec_price', 'total_cost_bps', 'price_impact_bps', 'fee_bps'], 'properties': {'size': {'type': 'number', 'title': 'Size', 'description': 'Sell size in human token units.'}, 'fee_bps': {'type': 'number', 'title': 'Fee Bps', 'description': 'Pool fee component, bps.'}, 'mid_price': {'type': 'number', 'title': 'Mid Price', 'description': 'Marginal price (out per 1 in) at size 0.'}, 'amount_out': {'type': 'number', 'title': 'Amount Out', 'description': 'Output-token units received (fee incl.).'}, 'exec_price': {'type': 'number', 'title': 'Exec Price', 'description': 'Realized price = amount_out / size.'}, 'total_cost_bps': {'type': 'number', 'title': 'Total Cost Bps', 'description': 'Loss vs mid (fee + slippage), bps.'}, 'price_impact_bps': {'type': 'number', 'title': 'Price Impact Bps', 'description': 'Slippage only (fee excluded), bps.'}}}, 'FragilityModel': {'type': 'object', 'title': 'FragilityModel', 'required': ['score', 'depth_score', 'concentration_score', 'convexity_score', 'total_exit_liquidity', 'venues'], 'properties': {'score': {'type': 'number', 'title': 'Score', 'description': '0..100, higher = more fragile.'}, 'venues': {'type': 'integer', 'title': 'Venues'}, 'depth_score': {'type': 'number', 'title': 'Depth Score'}, 'convexity_score': {'type': 'number', 'title': 'Convexity Score'}, 'concentration_score': {'type': 'number', 'title': 'Concentration Score'}, 'total_exit_liquidity': {'type': 'number', 'title': 'Total Exit Liquidity'}}}}, 'title': 'ExitCostResponse', 'required': ['tier', 'network', 'token', 'size', 'exit_cost', 'route'], 'properties': {'size': {'type': 'number', 'title': 'Size'}, 'tier': {'type': 'string', 'title': 'Tier'}, 'depeg': {'anyOf': [{'$ref': '#/$defs/DepegModel'}, {'type': 'null'}], 'default': None}, 'route': {'$ref': '#/$defs/RouteModel'}, 'token': {'type': 'string', 'title': 'Token'}, 'network': {'type': 'string', 'title': 'Network', 'description': 'testnet | mainnet'}, 'exit_cost': {'$ref': '#/$defs/ExitCostModel'}, 'fragility': {'anyOf': [{'$ref': '#/$defs/FragilityModel'}, {'type': 'null'}], 'default': None}, 'cross_check': {'anyOf': [{'$ref': '#/$defs/CrossCheck'}, {'type': 'null'}], 'default': None}, 'exit_cost_curve': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/CurvePoint'}}, {'type': 'null'}], 'title': 'Exit Cost Curve', 'default': None}, 'max_size_before_cost': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/MaxSizeEntry'}}, {'type': 'null'}], 'title': 'Max Size Before Cost', 'default': None}}}
Añadido
liquidity_exit_cost
17 de September de 2026 a las 12:45