magpie-mcp

# magpie-mcp

MCP (Model Context Protocol) server for **[Magpie Capital](https://magpie.capital)** — the Solana lending protocol for humans *and* AI agents.

Gives any MCP-capable LLM (Claude, etc.) native tools:

| Tool | What it answers |
|---|---|
| `magpie_protocol_stats` | Live on-chain protocol stats (loans, repayment rate, SOL lent) |
| `magpie_list_collateral` | The full live collateral catalog — 160+ tokens across memecoins, tokenized stocks/ETFs, gold & silver |
| `magpie_token_terms` | "Can I borrow against X, and on what terms?" — per-token LTV/fee/duration ladder |
| `magpie_x402_guide` | How autonomous agents borrow programmatically via x402 payment-gated endpoints |
| `magpie_borrow_quote` | **Live borrow quote** — real production numbers for any token/amount/tier, prices auto-resolved |
| `magpie_protocol_pulse` | Live 24h aggregates (loans, volume, repays, liquidations) by program version |
| `magpie_wallet_loans` | Any wallet's full on-chain loan history |
| `magpie_agent_leaderboard` | The on-chain credit league — top borrowers by credit score |
| `magpie_safety_brief` | **Read before advising a borrow** — real risks, no-margin-call terms, liquidation mechanics, Sec3 posture |

Read-only by design: this server holds no keys and signs nothing — the safe one-line mount for research and quoting.

**Want your agent to EXECUTE — borrow, arm exits, repay?** Use the full 26-tool desk: [`@magpieloans/magpie-mcp`](https://www.npmjs.com/package/@magpieloans/magpie-mcp) (registry: `io.github.magpiecapital/magpie-mcp`) — wraps every x402 endpoint, with an optional payer keypair for paid calls. Start here read-only; graduate there to act. Agent-side *execution* happens through Magpie's [x402 endpoints](https://magpie.capital/x402).

## Install (Claude Desktop / Claude Code)

```json
{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "github:magpiecapital/magpie-mcp"]
    }
  }
}
```

Claude Code: `claude mcp add magpie -- npx -y github:magpiecapital/magpie-mcp`

## More for LLMs
- https://magpie.capital/llms.txt · https://magpie.capital/llms-full.txt
- Live stats API: https://www.magpie.capital/api/v1/stats

MIT