pigi.finance — DeFi Vault Intelligence MCP server

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 riskband (A safest … F) and riskscore (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.

Listed in the official MCP registry 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)

{
  "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

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

Codex

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

Gemini CLI

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

OpenCode

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

Stdio-only clients (bridge through mcp-remote)

{
  "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)

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 PIGIMCPTOKEN=... 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 teaches an agent when and how to use the tools:

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

What you can ask

Shortened. The full README is on GitHub.