Tegro Finance DEX Server

npm npm downloads CI MCP License: MIT Telegram X

Tegro Finance MCP — a TON DeFi / DEX Model Context Protocol server. It lets an AI assistant (Claude, Cursor, ChatGPT, …) read live Tegro Finance DEX data on TON — pools, token prices, swap quotes and liquid‑staking (stgTON) rates — in plain language. AI access to live Tegro TON DEX data, with no wallet permissions.

Read‑only & non‑custodial. No API keys, no wallet, no signing — nothing that can move funds. It only reads the public Tegro Finance API. Just run it.

Tools

Tool	What it does
tegro_dex_pools	All liquidity pools — reserves, fees, TVL, APYs
tegro_dex_pools_for_token	Pools that contain a given token
tegro_dex_assets	The tradable‑token registry
tegro_dex_token	Price / holders / liquidity / trust score for a token
tegro_dex_quote_swap	Quote an exact‑in swap (read‑only; no tx built)
tegro_staking_pools	Liquid‑staking pools (stgTON & others) + APY
tegro_staking_rate	Live stgTON→TON rate for a pool

Install

Requires Node.js ≥ 18. No account, no keys, no env — the whole command is just:

npx -y @tegroton/tegro-finance-mcp

Wire that into any MCP client:

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tegro-finance": { "command": "npx", "args": ["-y", "@tegroton/tegro-finance-mcp"] }
  }
}

Claude Code

claude mcp add tegro-finance -- npx -y @tegroton/tegro-finance-mcp

Cursor

.cursor/mcp.json (project) or Settings → MCP → Add:

{
  "mcpServers": {
    "tegro-finance": { "command": "npx", "args": ["-y", "@tegroton/tegro-finance-mcp"] }
  }
}

Windsurf · VS Code (Cline) · ChatGPT · any MCP client

Same entry — command: "npx", args: ["-y", "@tegroton/tegro-finance-mcp"], no env. Add it to the client's MCP-servers list (Windsurf: Cascade MCP config; VS Code: Cline → MCP Servers; ChatGPT: Developer mode / MCP). For a ChatGPT custom GPT instead, see integrations/chatgpt-gpt.md.

What you can ask

• "What are the top Tegro Finance pools by TVL right now?"
• "Quote 100 TON → USDT on Tegro and show the price impact."
• "What's the current stgTON liquid-staking APY and rate?"
• "Show price, holders and liquidity for token <address>."
• "Which Tegro pools include <token>?"

How it works

Thin wrapper over the official @tegroton/tegro-finance SDK, which reads the public Tegro Finance API. The SDK is non‑custodial: building or signing a real swap happens in the user's own wallet and is intentionally not part of this read‑only server.

Tegro Finance ecosystem

• SDK — tegro-finance-sdk · @tegroton/tegro-finance — typed read/quote/build client + TON Connect adapter (powers this server)
• DEX API — API-DEX-TON-Blockchain — the public DEX REST API
• Liquid staking — ton-gram-staking-docs — stgTON docs, contracts & API
• App — tegro.finance · Docs — docs.tegro.finance

Other AI surfaces

Same read-only API, every assistant — see integrations/: llms.txt, an agent guide, a curated OpenAPI, a ChatGPT custom-GPT recipe, and Hermes/function-calling tools. llms.txt is live at https://tegro.finance/llms.txt.

Community

Telegram @tegrofinance · X @TegroDEX

Security

Read‑only. No keys, no signing, no funds. Outbound HTTPS only to the Tegro Finance API. See SECURITY.md.

Develop

npm install
npm run build
node dist/index.js   # stdio MCP server

MIT © TegroTON