# pigi.finance

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/pigi-fi/pigi-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pigi-finance

## Description
DeFi vault data from pigi.finance: yields, TVL, history and risk ratings across chains.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "pigi-finance": {
    "command": "npx",
    "args": ["-y","pigi-finance"]
  }
}
```

## Documentation & README

<p align="center">
  <img src="https://pigi.finance/favicon-512x512.png" width="96" alt="pigi.finance" />
</p>

# pigi.finance — DeFi Vault Intelligence MCP

Query 2,000+ DeFi vaults across 25+ protocols and 14 EVM chains. Get vault risk scores, APR/APY and TVL history, risk-adjusted yield, DeFi base rates and hack/exploit data — for Claude, Cursor, Codex, Gemini CLI and any other MCP client.

- **Remote server, no install.** Point your client at one URL, sign in with OAuth. No API key to copy, no environment variables.
- **Cross-protocol.** One tool surface over Aave, Morpho, Euler, Uniswap, Fluid, SparkLend, Yearn and more — compare vaults *across* protocols instead of one at a time.
- **Risk-rated.** Each assessed vault carries pigi's published `risk_band` (A safest … F) and `risk_score` (0–100), so an agent can rank by safety, not just yield.
- **Free tier.** 1,000 requests/month, all vault metrics and history. Pro raises the limit and adds holder analytics. See [pigi.finance/api-keys](https://pigi.finance/api-keys).

Listed in the [official MCP registry](https://registry.modelcontextprotocol.io/?q=pigi-mcp) as `io.github.pigi-fi/pigi-mcp`.

**Endpoint:** `https://mcp.pigi.finance/api/mcp` (Streamable HTTP)

## Install

**Any MCP client** (Claude Desktop, Cursor, Windsurf and most others: add to the MCP config file)

```json
{
  "mcpServers": {
    "pigi": { "url": "https://mcp.pigi.finance/api/mcp" }
  }
}
```

Or paste this into your agent and let it do the setup:

```
Read https://raw.githubusercontent.com/pigi-fi/pigi-skills/refs/heads/main/pigi-setup/SKILL.md and follow the instructions to connect to pigi.finance MCP
```

CLI clients:

**Claude Code**

```bash
claude mcp add pigi --transport http https://mcp.pigi.finance/api/mcp
```

**Codex**

```bash
codex mcp add pigi --url https://mcp.pigi.finance/api/mcp
```

**Gemini CLI**

```json
{
  "mcpServers": {
    "pigi": { "httpUrl": "https://mcp.pigi.finance/api/mcp" }
  }
}
```

**OpenCode**

```json
{
  "mcp": {
    "pigi": { "type": "remote", "url": "https://mcp.pigi.finance/api/mcp" }
  }
}
```

**Stdio-only clients** (bridge through `mcp-remote`)

```json
{
  "mcpServers": {
    "pigi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.pigi.finance/api/mcp"]
    }
  }
}
```

**Docker** (stdio bridge to the hosted server, for runners that need a local process)

```bash
git clone https://github.com/pigi-fi/pigi-mcp.git && cd pigi-mcp
docker build -t pigi-mcp .
docker run -i --rm -p 3334:3334 -v pigi-mcp-auth:/home/node/.mcp-auth pigi-mcp
```

First run prints a sign-in URL; open it on the host. The callback lands on port 3334, and the named volume keeps the token so later runs skip sign-in.

For non-interactive use (a directory inspector, a service), pass a service token instead and OAuth is skipped: `docker run -i --rm -e PIGI_MCP_TOKEN=... pigi-mcp`. Service tokens are issued by pigi.finance for specific integrations.

Runners that clone this repo into their own image instead of building the Dockerfile (Glama does this) need one build step, `npm install -g mcp-remote@0.14.2`, and the command `["/app/entrypoint.sh"]`; the script carries its own defaults.

### Authenticate

On first connect the client opens an OAuth 2.1 sign-in (WorkOS AuthKit). A free account is provisioned on first login. If you already use the pigi.finance REST API, sign in with the same email: the MCP shares that account's plan and quota.

Headless environments: `mcp-remote` prints the sign-in URL; open it anywhere, then pass the callback URL back.

### Skills (optional)

[pigi-fi/pigi-skills](https://github.com/pigi-fi/pigi-skills) teaches an agent when and how to use the tools:

```bash
npx skills add pigi-fi/pigi-skills --yes
```

## What you can ask

- "Find USDC lending vaults on Ethereum with APR above 10% and TVL over $10M, then rank them by risk score."
- "Compare the top Morpho and Euler USDC vaults on risk-adjusted yield over the last 90 days."
- "Which vaults in Morpho had net outflows this month?"
- "How does the DeFi base rate compare with the 3-month T-bill right now?"
- "How much was lost to bridge exploits in 2025?"

## Tools

- `list_vaults` — List DeFi vaults with TVL, APR, asset class, age, protocol, chain and, where assessed, `risk_band`, `risk_score` and `risk_adjusted_apr`. Filter by `protocol_name`, `chain_id`, `asset_class` (stable / mixed / non-stable), `search` (name substring, e.g. USDC), `risk_band` (e.g. ["A","B"]), `min_risk_score`, `tvl_filter`, `apr_filter`, `age_filter`; sort by `apr_desc`, `tvl_desc`, `risk_score_desc` or `risk_adjusted_apr_desc`; paginate with `limit` / `offset`. Returns `id` (for `get_vault`) and `strategy_id` (for history and stats).
- `get_vault` — Full record for one vault by pool `id`.
- `get_vault_history` — Daily series for a vault: TVL, APR, APY, risk-adjusted APR (APR minus a penalty derived from the risk score) and 30-day moving averages. Arguments: `strategy_id`, `range` (7D / 30D / 90D / 180D).
- `get_vault_stats` — Windowed aggregates for a vault: TVL low/high, APR, APY and net inflows over weekly, monthly, quarterly and yearly windows. Arguments: `strategy_id`, optional `period`.
- `get_rates` — DeFi Base Rate (stablecoin and ETH vault-set mean yield) and the 3-month U.S. T-bill rate, last ~30 daily points. No arguments.
- `get_hacks` — DeFi hack and exploit loss events plus major TradFi losses, with a `summary` totalling the whole filtered set. Arguments: `category`, `type` (DeFi / Dexes / Bridges), `from`, `to`, `min_amount`, `sort`, `limit`, `offset`.
- `get_usage` — Your request count this month and plan limit. No arguments.

"Best low-risk USDC vault" is a single call: `list_vaults({ search: "USDC", asset_class: "stable", risk_band: ["A", "B"], sort: "risk_adjusted_apr_desc" })`.

## Coverage

2,000+ vaults · 25+ protocols · 14 EVM chains · lending markets, ERC-4626 vaults, AMM pools and stability pools. Data is refreshed daily. Risk ratings are published for the vaults pigi has assessed; the live count is on [pigi.finance](https://pigi.finance).

## About this repo

This repo is the public listing for the pigi.finance MCP server: the registry manifest (`server.json`), the publish workflow, and this README. The server itself is a hosted service; its code is not published here.

Releases: bump `version` in `server.json`, commit, tag `vX.Y.Z` and push the tag. The workflow validates the manifest and publishes to the registry with GitHub OIDC. The registry never overwrites a published version.

## Links

- Setup page: [app.pigi.finance/defi-mcp](https://app.pigi.finance/defi-mcp)
- REST API docs: [app.pigi.finance/defi-api-docs](https://app.pigi.finance/defi-api-docs)
- Skills: [github.com/pigi-fi/pigi-skills](https://github.com/pigi-fi/pigi-skills)
- Registry entry: [registry.modelcontextprotocol.io/?q=pigi-mcp](https://registry.modelcontextprotocol.io/?q=pigi-mcp)

Tags: DeFi · Finance · Cryptocurrency · Blockchain · Web3 · Yield · Vaults · Risk · Risk Analytics · On-chain Data · Aave · Morpho · Euler · Uniswap · EVM