# Tegro Finance DEX — MCP server

![Tegro Finance DEX MCP](assets/banner.png)

[![npm](https://img.shields.io/npm/v/@tegroton/tegro-finance-mcp)](https://www.npmjs.com/package/@tegroton/tegro-finance-mcp)
[![npm downloads](https://img.shields.io/npm/dm/@tegroton/tegro-finance-mcp)](https://www.npmjs.com/package/@tegroton/tegro-finance-mcp)
[![CI](https://github.com/TegroTON/tegro-finance-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/TegroTON/tegro-finance-mcp/actions/workflows/ci.yml)
[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Telegram](https://img.shields.io/badge/Telegram-@tegrofinance-2AABEE?logo=telegram)](https://t.me/tegrofinance)
[![X](https://img.shields.io/badge/X-@TegroDEX-000000?logo=x)](https://x.com/TegroDEX)

**Tegro Finance MCP** — a TON DeFi / DEX [Model Context Protocol](https://modelcontextprotocol.io)
server. It lets an AI assistant (Claude, Cursor, ChatGPT, …) read live
**[Tegro Finance](https://tegro.finance) DEX** data on [TON](https://ton.org) —
**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](https://nodejs.org) ≥ 18. No account, no keys, no `env` — the
whole command is just:

```bash
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`):

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

### Claude Code

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

### Cursor

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

```json
{
  "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`](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`](https://www.npmjs.com/package/@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`](https://github.com/TegroTON/tegro-finance-sdk) · [`@tegroton/tegro-finance`](https://www.npmjs.com/package/@tegroton/tegro-finance) — typed read/quote/build client + TON Connect adapter (powers this server)
- **DEX API** — [`API-DEX-TON-Blockchain`](https://github.com/TegroTON/API-DEX-TON-Blockchain) — the public DEX REST API
- **Liquid staking** — [`ton-gram-staking-docs`](https://github.com/TegroTON/ton-gram-staking-docs) — stgTON docs, contracts & API
- **App** — [tegro.finance](https://tegro.finance) · **Docs** — [docs.tegro.finance](https://docs.tegro.finance)

## Other AI surfaces

Same read-only API, every assistant — see [`integrations/`](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](https://t.me/tegrofinance) · X [@TegroDEX](https://x.com/TegroDEX)

## Security

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

## Develop

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

MIT © TegroTON