LCX Liberty DEX MCP

A hosted MCP server for LCX Liberty DEX that provides read-only access to swap quotes, token search, USD prices, and chain information across EVM chains without executing trades.

Visit LCX Liberty

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by LCX Liberty

You need:The Authorization header is required: every tool call needs a valid LCX Liberty API keyThe Free plan's key is enough, and it is created in the console in a minute

MCP endpoint (Streamable HTTP)

https://swap-api.lcx.com/mcp

Vendor documentation

What you can do with it

Get best route and expected output for a token pair
Resolve a ticker symbol into a contract address
Retrieve USD price based on real pool depth
List supported chains and check index health

Source and maintenance

Community listingRegistry 0.1.1

mcp-registry: io.github.LCX-AG/lcx-liberty-dex@0.1.1 Project website

Protocol and capabilities

Server: lcx-liberty 0.1.0
MCP protocol: 2025-06-18
Tools: 5 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Best-execution DEX routing across Ethereum, Base, Arbitrum One, OP Mainnet, Robinhood Chain, BNB Chain, Polygon, Avalanche, Unichain, Monad, Arc, HyperEVM, World Chain and Cronos, priced from the pools LCX Liberty DEX indexes itself. Resolve tickers with search_tokens before calling get_quote. Quotes are read-only and never execute a trade.

Tools

5 advertised

get_quote

Advertised by the server during the last successful anonymous check.

Best route and expected output for selling a specific amount of one token for another on one chain, priced from the pools LCX Liberty DEX indexes itself. Use it for what an amount would swap for; use get_price for a token's value, and search_tokens first to turn a ticker into an address. Read-only: it never executes a trade. Returns output.amount and output.minimumAmount (at 0.5% slippage) in tokenOut's base units, with output.decimals to scale them; priceImpactPct, gasFeeUSD, the venues and the per-hop routes; and blockNumber and expiresAt, since a quote is priced at one block and lives 120 seconds. When there is no quote, the result is an error that says why: no route between the two tokens, or liquidity too thin for this size, usually naming a size that would fill.

get_quote input schema

{
  "type": "object",
  "required": [
    "chainId",
    "tokenIn",
    "tokenOut",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "pattern": "^\\s*(\\d+(\\.\\d*)?|\\.\\d+)([eE][+-]?\\d+)?\\s*$",
      "description": "Positive human amount of tokenIn to sell, e.g. \"1.5\". Scaled by the token's own decimals, which the server knows: do not send decimals."
    },
    "chainId": {
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999,
        480,
        25
      ],
      "type": "integer",
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM, 480 World Chain, 25 Cronos"
    },
    "tokenIn": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Sell token address. Use the zero address for native ETH."
    },
    "decimals": {
      "type": "integer",
      "maximum": 36,
      "minimum": 0,
      "description": "Optional, and best left out. Only for a token the index holds no decimals for; a value that disagrees with the token's own is refused (decimals_mismatch)."
    },
    "tokenOut": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Buy token address."
    }
  },
  "additionalProperties": false
}

search_tokens

Advertised by the server during the last successful anonymous check.

Finds tokens on one chain by symbol, name or address, and gives the address get_quote and get_price need. Use it whenever you have a ticker or a name instead of an address. Read-only. Matching is case-insensitive on any part of the symbol, name or address; with no search it lists the chain's tokens. Results are ranked: the chain's curated tokens first, then other indexed tokens by how many pools hold them. A symbol is not unique, so when several match, prefer the verified one or the one with the most depth. Each result has address (the zero address for the native coin), symbol, name, decimals, verified, poolCount and depthUsd; hasMore says more matched than limit returned. A token refused for a transfer tax is left out unless its exact address is searched, which returns it with transferTaxBps.

search_tokens input schema

{
  "type": "object",
  "required": [
    "chainId"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max results to return. Default 10, at most 50."
    },
    "search": {
      "type": "string",
      "description": "Any part of a symbol, name or address, case-insensitive, e.g. \"usdc\" or \"0x833589\". Leave it out to list the chain's tokens."
    },
    "chainId": {
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999,
        480,
        25
      ],
      "type": "integer",
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM, 480 World Chain, 25 Cronos"
    }
  },
  "additionalProperties": false
}

get_price

Advertised by the server during the last successful anonymous check.

USD price of one whole token on one chain, priced from the pools LCX Liberty DEX indexes itself (real depth, not a mid-market feed). Use it for a token's value; use get_quote for what a specific amount would swap for, and search_tokens first to turn a ticker into an address. Read-only. Returns usd, change24h (a ratio: 0.0123 is +1.23%), source, and the age of the pool state behind the price (asOfBlock, ageSeconds, stale). When there is no honest price, usd is null and reason says why (for example token_not_indexed or below_depth_floor) instead of an error.

get_price input schema

{
  "type": "object",
  "required": [
    "chainId",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Token address on that chain. Use the zero address for the chain's native coin; on Arc, whose native coin is USDC, use its contract 0x3600000000000000000000000000000000000000."
    },
    "chainId": {
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999,
        480,
        25
      ],
      "type": "integer",
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM, 480 World Chain, 25 Cronos"
    }
  },
  "additionalProperties": false
}

list_chains

Advertised by the server during the last successful anonymous check.

Every chain LCX Liberty DEX serves, with the live health of its index. Call it to learn which chainId values the other tools accept and whether a chain is quoting right now, or to explain a refused or stale answer from get_quote or get_price. Read-only, takes no arguments, and does not count against the API key's quota. Each entry has chainId, key, name, nativeSymbol, wrappedNative, router (the address a swap approves), ready (fresh enough to build a swap), degraded (still quoting, prices indicative only), available, unavailableReason (why not, when it is not) and ageSeconds, how long since the index recorded a new block, judged against freshnessLimitSeconds.

list_chains input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_my_usage

Advertised by the server during the last successful anonymous check.

Reads the calling API key's own plan and usage, so no key or account id is passed. Use it to answer questions about quota or throttling, or before a long run of calls. Read-only, live, and it does not count against the quota. Returns plan and planLabel; callsUsed, monthlyCalls and callsRemaining for the current billing period (monthlyCalls and callsRemaining are null when the plan has no cap); and rateLimit as perSecond and perMinute, where a slow request uses more than one. Only successful calls are counted, and at the limit calls are refused, never billed as overage.

get_my_usage input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 787 ms
95th percentile latency: 787 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 8:54 AM UTC · probe · passed · 787 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http lcx-liberty-dex-mcp https://swap-api.lcx.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add lcx-liberty-dex-mcp --url https://swap-api.lcx.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable lcx-liberty-dex-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "lcx-liberty-dex-mcp": {
      "url": "https://swap-api.lcx.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "lcx-liberty-dex-mcp": {
      "type": "streamableHttp",
      "url": "https://swap-api.lcx.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start lcx-liberty-dex-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "lcx-liberty-dex-mcp": {
      "type": "http",
      "url": "https://swap-api.lcx.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http lcx-liberty-dex-mcp https://swap-api.lcx.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "lcx-liberty-dex-mcp": {
      "url": "https://swap-api.lcx.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "lcx-liberty-dex-mcp": {
      "serverUrl": "https://swap-api.lcx.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like LCX Liberty DEX MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows