Skip to main content
Glama
LPSignal MCP Server

LPSignal MCP Server

Official
README.md
# LPSignal MCP Server — Uniswap & DeFi liquidity pool APR for AI agents

[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-app.lpsignal%2Flpsignal-blue)](https://registry.modelcontextprotocol.io/v0.1/servers?search=app.lpsignal/lpsignal)
[![Website](https://img.shields.io/badge/website-lpsignal.app-0b7285)](https://lpsignal.app)
[![Docs](https://img.shields.io/badge/docs-lpsignal.app%2Fdocs-0b7285)](https://lpsignal.app/docs)
[![X](https://img.shields.io/badge/X-%40lpsignalhq-000000?logo=x&logoColor=white)](https://x.com/lpsignalhq)
[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/buKQT9mkaF)
[![Telegram](https://img.shields.io/badge/Telegram-%40LPsignals__bot-26A5E4?logo=telegram&logoColor=white)](https://t.me/LPsignals_bot)
[![npm](https://img.shields.io/npm/v/lpsignal?label=npm%20lpsignal)](https://www.npmjs.com/package/lpsignal)
[![PyPI](https://img.shields.io/pypi/v/lpsignal?label=PyPI%20lpsignal)](https://pypi.org/project/lpsignal/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

A hosted **Uniswap and DeFi MCP server** (Model Context Protocol) that lets AI agents — Claude, Cursor, VS Code Copilot,
any MCP client — find the best **concentrated-liquidity pools and price ranges**, ranked by **net APR: fees minus
impermanent loss**, from hourly backtests on exact on-chain fees. Ask your agent which Uniswap v3 range to LP in,
backtest a range, or check impermanent loss, and it answers with live data from [LPSignal](https://lpsignal.app).

| Endpoint | For |
|---|---|
| `https://api.lpsignal.app/v1/mcp` | **Your account.** Your app opens lpsignal.app, you sign in with your wallet and click Allow (OAuth 2.1). Or send an API key. |
| `https://api.lpsignal.app/v1/mcp/public` | **No sign-in.** The free view, for a quick look or clients without OAuth. |

Remote server (Streamable HTTP): nothing to install. Official MCP Registry name: `app.lpsignal/lpsignal`.

## Why net APR, not fee APR

DEX sites and most APR trackers show a pool's **fee APR**. What a liquidity provider keeps is the fee income of *their
price range* minus *impermanent loss*. LPSignal backtests 3–4 ranges per pool every hour over 1 hour, 24 hours, 7 days and
30 days, using each pool's exact `feeGrowthGlobal` counters rather than volume estimates, and ranks ranges by what they
netted. Every signal is re-backtested on its exact ticks afterwards and published, losses included.

## Supported chains and DEXes

| Chain | DEXes |
|---|---|
| Ethereum | Uniswap v3, Uniswap v4, PancakeSwap v3 |
| Base | Uniswap v3, Uniswap v4, Aerodrome Slipstream, PancakeSwap v3 |
| Arbitrum | Uniswap v3, Uniswap v4, PancakeSwap v3 |
| BNB Chain | PancakeSwap v3, Uniswap v3, Uniswap v4 |
| Optimism | Uniswap v3, Uniswap v4, Velodrome Slipstream |
| Polygon | Uniswap v3, Uniswap v4 |
| Robinhood Chain | Uniswap v3, Uniswap v4 |

Pools whose two tokens are established assets (stablecoins, ETH and BTC wrappers, liquid staking tokens, tokens over
$100M market cap). Uniswap v4 pools without hooks and with a static fee.

## Quick start

Add `https://api.lpsignal.app/v1/mcp` and connect: your client opens lpsignal.app, you sign in with your wallet and
click **Allow**. A free LPSignal account works (the free view); Basic and Pro see signals live. Disconnect any time in
your [account](https://lpsignal.app/account). No OAuth in your client? Send an API key in
`Authorization: Bearer lps_…`, or use `/v1/mcp/public` without signing in.

**Claude (web / desktop)**: Settings → Connectors → Add custom connector → URL `https://api.lpsignal.app/v1/mcp` →
Connect.

**ChatGPT**: Settings → Connectors (developer mode) → Create → URL `https://api.lpsignal.app/v1/mcp`, authentication
OAuth.

**Claude Code**: as a plugin (the server plus a skill that tells Claude how to use it):

```
/plugin install lpsignal --marketplace LPSignals/lpsignal-mcp
```

On Claude Code before 2.1.275: `/plugin marketplace add LPSignals/lpsignal-mcp`, then `/plugin install lpsignal@lpsignal`.
Or just the server:

```bash
claude mcp add --transport http lpsignal https://api.lpsignal.app/v1/mcp
# then /mcp in Claude Code to sign in. Or with an API key:
claude mcp add --transport http lpsignal https://api.lpsignal.app/v1/mcp --header "Authorization: Bearer lps_…"
```

**Cursor** (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "lpsignal": { "url": "https://api.lpsignal.app/v1/mcp" }
  }
}
```

**VS Code** (`.vscode/mcp.json`)

```json
{
  "servers": {
    "lpsignal": { "type": "http", "url": "https://api.lpsignal.app/v1/mcp" }
  }
}
```

Cursor and VS Code ask you to sign in on first use. To skip sign-in, point them at
`https://api.lpsignal.app/v1/mcp/public` (the free view).

## Tools

All read-only: the server never touches funds or wallets.

| Tool | What it answers |
|---|---|
| `list_pools` | Liquidity pools ranked by their best range's net APR over 1 h / 24 h / 7 d / 30 d, by chain and pool class (stable, correlated, volatile) |
| `find_pair_pools` | Every pool of a token pair across chains, DEXes and fee tiers, e.g. `USDC` + `WETH` |
| `get_pool` | One pool: each range's fee APR, impermanent loss, net APR, time in range and exact ticks |
| `backtest_range` | Backtest any ±x% price range (or full range) on a pool over the last 1–30 days |
| `list_signals` | Latest LP signals: opportunities (`net_apr`, `burst`, `hot_pool`) and risk alerts (stablecoin `depeg`, `tvl_outflow`); each says `access: live` or `delayed_24h` |
| `signal_track_record` | How past signals really did, re-backtested on their exact ticks |
| `smart_lp_leaderboard` | Wallets ranked by what their closed LP positions made versus holding the tokens |
| `my_account` | Your plan, subscriptions and custom alert rules (signed in; not on `/public`) |

APRs come back as percent text (`"42.0%"`) so a model never misreads a fraction, and every pool links to its page on
lpsignal.app.

## Example prompts

- "Which USDC/WETH pool and price range paid the most after impermanent loss this week?"
- "Best stablecoin pools on Base to provide liquidity in right now?"
- "Backtest a ±5% range on the top Aerodrome pool over the last 14 days."
- "What would a full-range Uniswap v3 position in ETH/USDC have earned net of impermanent loss over 30 days?"
- "Any stablecoin depegs or liquidity outflows in the last 24 hours?"
- "How have past LPSignal opportunity signals actually performed?"

## Free and paid

| | No sign-in (`/public`) or a free account | Basic / Pro account |
|---|---|---|
| Pool rankings, pair search, backtests, track record | ✓ | ✓ |
| Risk alerts (depeg, liquidity outflow) | live | live |
| Opportunity signals | 24 hours after they fire | live |
| Smart-LP leaderboard | top 10, addresses masked | full (Pro) |
| Your custom alert rules | — | ✓ |

[Plans and pricing](https://lpsignal.app/pricing).

## FAQ

**Is there an MCP server for Uniswap liquidity pools?** Yes: this one covers Uniswap v3 and v4 (plus PancakeSwap v3,
Aerodrome and Velodrome Slipstream) on seven chains, with backtested net APR per price range.

**How do I calculate impermanent loss with an AI agent?** Connect this server and ask for a backtest
(`backtest_range`): it returns fee APR, impermanent loss and net APR of that exact range over the last 1–30 days.

**Do I need an API key?** No. Sign in with your wallet when your app asks (OAuth), or use `/v1/mcp/public` without
signing in. An API key is only for clients without OAuth.

**Can the agent add liquidity for me?** No. Every tool is read-only. LPSignal's website lets you add liquidity from your
own wallet on the DEX's official contract.

**Is this financial advice?** No. Figures are backtests of past on-chain data, not forecasts. A range that paid well can
lose money if the price moves out of it.

## Related

- REST API: [OpenAPI 3.1](https://api.lpsignal.app/v1/openapi.json) · [documentation](https://lpsignal.app/docs) · [how net APR is measured](https://lpsignal.app/methodology)
- SDKs: [Node.js](https://github.com/LPSignals/lpsignal-node) ([npm](https://www.npmjs.com/package/lpsignal): `npm i lpsignal`) · [Python](https://github.com/LPSignals/lpsignal-python) ([PyPI](https://pypi.org/project/lpsignal/): `pip install lpsignal`)
- Live push: WebSocket stream, signed webhooks, Telegram
- Website: [lpsignal.app](https://lpsignal.app) — pool pages, [token pairs](https://lpsignal.app/pairs), [LP returns report](https://lpsignal.app/reports/lp-returns), [signals and track record](https://lpsignal.app/signals), [smart-LP leaderboard](https://lpsignal.app/smart-lps), [pricing](https://lpsignal.app/pricing)

## Community and support

- **X**: [@lpsignalhq](https://x.com/lpsignalhq) — product updates
- **Discord**: [discord.gg/buKQT9mkaF](https://discord.gg/buKQT9mkaF) — questions, feedback, the free signal feed
- **Telegram bot**: [@LPsignals_bot](https://t.me/LPsignals_bot) — signals pushed to your chat
- **Telegram support**: [t.me/lpsignal_support](https://t.me/lpsignal_support)
- **Email**: [support@lpsignal.app](mailto:support@lpsignal.app)
- **GitHub**: [github.com/LPSignals](https://github.com/LPSignals)

## 中文

**LPSignal MCP 服务**:Uniswap / DeFi 流动性池的 MCP 服务器,托管在 `https://api.lpsignal.app/v1/mcp`(Streamable HTTP),无需安装。
让 Claude、Cursor 等 AI agent 直接查询集中流动性池的**净 APR(手续费 − 无常损失)**排名、某个交易对在各链各费率的池子、任意价格区间的回测、
最新 LP 信号、信号历史表现和聪明 LP 排行,支持 Ethereum、Base、Arbitrum、BNB Chain、Optimism、Polygon、Robinhood Chain 上的
Uniswap v3/v4、PancakeSwap v3、Aerodrome、Velodrome。全部工具只读,不碰资金。连接
`https://api.lpsignal.app/v1/mcp` 时,应用会打开 lpsignal.app,用钱包登录并点“允许”(OAuth 2.1)即可,之后按你的套餐返回内容,可在
[账户页](https://lpsignal.app/zh/account)随时断开;也可以在请求头放 API 密钥 `Authorization: Bearer lps_…`。不想登录用
`https://api.lpsignal.app/v1/mcp/public`(免费视图)。数据是历史回测,不是预测,也不构成投资建议。

Claude Code 插件(服务器 + 使用说明 skill):`/plugin install lpsignal --marketplace LPSignals/lpsignal-mcp`。

社区与支持:[X @lpsignalhq](https://x.com/lpsignalhq) · [Discord](https://discord.gg/buKQT9mkaF) · Telegram 信号机器人 [@LPsignals_bot](https://t.me/LPsignals_bot) · [Telegram 客服](https://t.me/lpsignal_support) · [support@lpsignal.app](mailto:support@lpsignal.app) · [中文官网](https://lpsignal.app/zh)

## License

MIT