@tegroton/tegro-finance-mcp
v0.1.0
Published
Model Context Protocol server for the Tegro Finance DEX on TON — let an AI assistant read pools, token prices, swap quotes and liquid-staking (stgTON) rates. Read-only, no keys, no signing. Built on @tegroton/tegro-finance.
Maintainers
Readme
Tegro Finance DEX — MCP server

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-mcpWire 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-mcpCursor
.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 serverMIT © TegroTON
