Skip to main content
TopLedger
Model Context Protocol

Built for AI Agents

Connect Claude, Cursor, or any MCP-compatible agent to Solana DeFi data. 10 wallet-centric tools for portfolio analysis, positions, and PnL tracking.

Claude Desktop
Cursor IDE
Any MCP Client
MCP Endpoint
https://api.topledger.xyz/mcp/sse

Authenticate via x-api-key header

Get API Key

Pay.sh access

Pay per call, no Top Ledger API key required

Agents can use the Pay.sh gateway for wallet intelligence endpoints at https://api.topledger.xyz/pay. Calls are priced at $0.0004 each and settle through MPP in Solana USDC.

Check gateway
0
Agent Tools
<0ms
Avg Latency
0 credit
Per Tool Call

Integration

Setup in under 30 seconds

1. Edit your config file

~/Library/Application Support/Claude/claude_desktop_config.json(macOS)%APPDATA%\Claude\claude_desktop_config.json(Windows)
claude_desktop_config.json
{
  "mcpServers": {
    "topledger": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.topledger.xyz/mcp/sse",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your key, then restart Claude Desktop. Tools appear in the MCP panel.

Capabilities

10 Agent Tools

Every tool accepts a wallet address and returns real-time Solana DeFi data.

Master Tool
analyze_wallet

Complete portfolio overview—total net worth, all DeFi positions, token holdings, and DEX trading PnL in a single call.

“What is wallet X's total portfolio value?”

Covers all categories

Lending
Perps
Staking
Governance
Liquidity
Yield
Rewards
Trading
Holdings
Or query specific categories
Lending
get_all_lending

Deposits, borrows, health factors, and net value across 6 lending protocols.

KaminoProject ZeroLoopscaleJupiter LendHumaCarrot

“Show me the lending positions for wallet X”

Perps
get_all_perps

Open positions, collateral, PnL, and funding rates across perpetual DEXs.

Jupiter PerpsFlash Trade

“Does wallet X have any open perp positions?”

Staking
get_all_staking

Native SOL, liquid staking, and protocol-specific staking positions.

Native SOLDrift IFJupiter DAOFlashHeliumSeekerHumaRaydiumKaminoPythM3M3Solomon

“How much SOL is wallet X staking?”

Governance
get_all_governance

Governance token deposits across SPL Governance / Realms and Tribeca DAOs.

RealmsTribeca

“Show me governance deposits for wallet X”

Liquidity
get_all_lp

Active LP positions with reserves, fee accrual, and price ranges.

Meteora DLMMDAMM V2Orca WhirlpoolRaydium

“What LP positions does wallet X have?”

Yield
get_all_yield

Vault deposits, exchange rates, and yield accrual across yield protocols.

Kamino VaultsHyloCarrotPerenaExponentElementalHumaHawkFiLoopscale

“Show me yield positions for wallet X”

Rewards
get_all_rewards

Unclaimed rewards, fuel points, and pending distributions.

KaminoLoopscale

“Does wallet X have any unclaimed rewards?”

Trading
get_all_dex

FIFO cost basis, realized + unrealized PnL, and 7-day trading performance.

All Solana DEXs

“What is wallet X's trading PnL this week?”

Holdings
get_holdings

Native SOL plus Jupiter-verified SPL / Token-2022 balances with real-time USD pricing.

SOLJupiter-verified tokens

“What tokens does wallet X hold?”

In Action

See it work

U

What's the portfolio breakdown for wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?

AI

I'll analyze this wallet using the TopLedger MCP.

Tool call
$ analyze_wallet({ "wallet": "7xKX...sAsU" })189ms

This wallet has $12,450 total value:

Holdings

$8,20066%

Kamino Lending

$2,10017%

Orca LP

$1,95015%

DEX PnL (7d)

+$340

Ready to connect?

Get your free API key and start querying Solana DeFi data from any AI agent.

Get API Key