Solana MCP Server - Real-time Solana Data for AI

Getting Started

The Solana MCP API provides real-time access to Solana blockchain data. All requests require authentication via an API key.

Base URL

https://solana-mcp-2zfc.vercel.app/api

Authentication

Include your API key in the request headers:

X-API-Key: your_api_key_here

Available Tools (16 total)

7 Core Tools9 Security Tools

Get SOL Balance

Cost: 5¢ per request

GET

Get SOL and SPL token balances for any Solana wallet address.

Endpoint

POST /api/tools/get_sol_balance

Request Body

{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Response

{
  "success": true,
  "data": {
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "sol": 47.9316,
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "amount": 150.5000,
        "decimals": 6
      }
    ]
  }
}

Get NFT Holdings

Cost: 5¢ per request

GET

Retrieve all NFTs owned by a wallet with full metadata.

Endpoint

POST /api/tools/get_nft_holdings

Request Body

{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Response

{
  "success": true,
  "data": {
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "count": 38,
    "nfts": [
      {
        "mint": "Abc123...",
        "name": "Cool NFT #123",
        "symbol": "COOL",
        "image": "https://...",
        "collectionName": "Cool Collection"
      }
    ]
  }
}

Get Token Price

Cost: 3¢ per request

GET

Get current USD price and 24-hour change for any cryptocurrency.

Endpoint

POST /api/tools/get_token_price

Request Body

{
  "symbol": "SOL"
}

Supports: SOL, ETH, BTC, USDC, USDT, BNB, XRP, ADA, DOGE, MATIC, DOT, AVAX, LINK, UNI, ATOM, and more.

Response

{
  "success": true,
  "data": {
    "symbol": "SOL",
    "price": 194.01,
    "change24h": 7.20,
    "marketCap": 106116206493
  }
}

Get Transaction History

Cost: 5¢ per request

NEW

Retrieve recent transaction history for a Solana wallet.

Endpoint

POST /api/tools/get_transaction_history

Request Body

{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "limit": 10  // Optional, default 10, max 100
}

Response

{
  "success": true,
  "data": {
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "count": 10,
    "transactions": [
      {
        "signature": "5a1b2c3d4e...",
        "type": "TRANSFER",
        "timestamp": 1699564800,
        "description": "Sent 1 SOL"
      }
    ]
  }
}

Get Portfolio Value

Cost: 7¢ per request

NEW

Calculate total portfolio value in USD for a Solana wallet, including SOL and all known tokens.

Endpoint

POST /api/tools/get_portfolio_value

Request Body

{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Response

{
  "success": true,
  "data": {
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "totalValueUsd": 9234.01,
    "breakdown": {
      "sol": {
        "amount": 47.9316,
        "priceUsd": 192.65,
        "valueUsd": 9234.01
      },
      "tokens": [
        {
          "symbol": "USDC",
          "amount": 150.50,
          "priceUsd": 1.00,
          "valueUsd": 150.50
        }
      ],
      "unknownTokens": 5
    }
  }
}

Get Swap Quote

Cost: 4¢ per request

NEW

Get the best swap quote from Jupiter DEX aggregator for Solana tokens.

Endpoint

POST /api/tools/get_swap_quote

Request Body

{
  "inputToken": "SOL",
  "outputToken": "USDC",
  "amount": 1,
  "slippageBps": 50  // Optional, default 50 (0.5%)
}

Supported tokens: SOL, USDC, USDT, BONK, JUP, RAY, ORCA, or any token mint address

Response

{
  "success": true,
  "data": {
    "input": "SOL",
    "output": "USDC",
    "inAmount": 1,
    "outAmount": 194.25,
    "priceImpactPct": 0.05,
    "routes": [
      {
        "marketName": "Raydium",
        "percent": 100
      }
    ]
  }
}

Get Token Security

Cost: 8¢ per request

SECURITY

Analyze token security and detect potential scams. Checks freeze/mint authority, holder distribution, and calculates risk score.

Endpoint

POST /api/tools/get_token_security

Request Body

{
  "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}

Response

{
  "success": true,
  "data": {
    "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "riskScore": 25,
    "riskLevel": "LOW",
    "checks": {
      "freezeAuthority": {
        "status": "SAFE",
        "value": null,
        "description": "✅ No freeze authority"
      },
      "mintAuthority": {
        "status": "SAFE",
        "value": null,
        "description": "✅ Supply is fixed"
      },
      "topHolderConcentration": {
        "status": "SAFE",
        "value": "12.5%",
        "description": "Top holder owns 12.5% of supply"
      },
      "holderDistribution": {
        "status": "SAFE",
        "value": "45.2%",
        "description": "Top 10 holders own 45.2% of supply"
      }
    },
    "warnings": [],
    "metadata": {
      "name": "Bonk",
      "symbol": "BONK",
      "supply": 93000000000000,
      "decimals": 5
    }
  }
}

Get Token Metadata

Cost: 4¢ per request

SECURITY

Get enhanced token metadata with images, social links, and market data.

Endpoint

POST /api/tools/get_token_metadata

Request Body

{
  "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}

Response

{
  "success": true,
  "data": {
    "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "BONK",
    "description": "Bonk is a dog-themed meme coin...",
    "image": "https://arweave.net/...",
    "supply": 93000000000000,
    "decimals": 5,
    "socials": {
      "website": "https://bonkcoin.com",
      "twitter": "https://twitter.com/bonk_inu",
      "telegram": "https://t.me/bonkinu",
      "discord": "https://discord.gg/bonk"
    },
    "verified": true,
    "tags": ["meme", "dog"],
    "marketData": {
      "priceUsd": 0.0000123,
      "volume24h": 15000000,
      "liquidity": 8500000,
      "fdv": 1145000000,
      "priceChange24h": 5.3
    }
  }
}

Get Top Holders

Cost: 6¢ per request

SECURITY

Analyze top token holders with bot detection and bundle detection. Shows distribution metrics, identifies suspicious wallets, and detects bundled tokens (multiple wallets funded from the same source).

Endpoint

POST /api/tools/get_top_holders

Request Body

{
  "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "limit": 20  // Optional, default 20, max 50
}

Response

{
  "success": true,
  "data": {
    "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "totalHolders": 100,
    "topHolders": [
      {
        "rank": 1,
        "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "amount": 11625000000000,
        "percentage": 12.5,
        "botScore": 15,
        "isLikelyBot": false,
        "fundingSource": "9xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJo123",
        "bundleGroup": null,
        "tags": ["TOP_HOLDER", "LARGE_HOLDER"]
      }
    ],
    "distribution": {
      "top1Percent": 12.5,
      "top5Percent": 35.2,
      "top10Percent": 45.8,
      "giniCoefficient": 0.42,
      "concentrationLevel": "MEDIUM"
    },
    "bundleDetection": {
      "isBundled": false,
      "totalBundles": 0,
      "totalBundledHolders": 0,
      "bundledPercentage": "0.00",
      "bundleRisk": "NONE",
      "bundles": []
    },
    "alerts": [
      "✅ No major distribution concerns detected"
    ]
  }
}

🔍 Bundle Detection

Bundle detection identifies when multiple wallets were funded from the same source wallet. This is a common scam technique where creators distribute tokens across many wallets to make it look decentralized, when in reality they control all of them. The bundleRisk ranges from NONE to CRITICAL based on how much supply is controlled by bundled wallets.

Get Price History

Cost: 5¢ per request

SECURITY

Get historical price data for charting. Returns price points over specified timeframe.

Endpoint

POST /api/tools/get_price_history

Request Body

{
  "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "timeframe": "7d"  // Options: 24h, 7d, 30d, 90d, 1y
}

Response

{
  "success": true,
  "data": {
    "mintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "timeframe": "7d",
    "currentPrice": 0.0000123,
    "priceChange": 15.5,
    "allTimeHigh": 0.0000145,
    "volume24h": 15000000,
    "liquidity": 8500000,
    "priceHistory": [
      {
        "timestamp": 1699564800,
        "price": 0.0000115,
        "volume": 12500000
      }
    ],
    "summary": {
      "change": 15.5,
      "changePercent": 15.5,
      "high": 0.0000125,
      "low": 0.0000110,
      "average": 0.0000118
    }
  }
}

Get Staking Info

Cost: 5¢ per request

SECURITY

Get SOL staking information for a wallet. Shows active stake, validators, estimated APY, and rewards.

Endpoint

POST /api/tools/get_staking_info

Request Body

{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Response

{
  "success": true,
  "data": {
    "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "hasStake": true,
    "totalStaked": 100.5,
    "activeStake": 95.0,
    "inactiveStake": 5.5,
    "activatingStake": 0,
    "deactivatingStake": 0,
    "validators": [
      {
        "address": "CogentC52e7kktFfWHwsqSmr8LiS1yAtfqhHcftCPcBJ",
        "stake": 50.0,
        "name": "Cogent Validator",
        "commission": 5,
        "apy": 7.2
      },
      {
        "address": "J1to3PQfXidUUhprQWgdKkQAMWPJAEqSJ7amkBDE9qhF",
        "stake": 45.0,
        "name": "Jito Validator",
        "commission": 8,
        "apy": 7.8
      }
    ],
    "estimatedApy": 7.48,
    "estimatedYearlyRewards": 7.11
  }
}

Get Creator Analysis

Cost: 10¢ per request

SECURITY

Analyze token creator history and detect serial scammers. Identifies the creator wallet, finds all tokens they created, detects rug pulls, and calculates a reputation score.

Endpoint

POST /api/tools/get_creator_analysis

Request Body

{
  "mintAddress": "AVdsFsS45YjGEitb7yQy3XqnNsMVGL3o4cYA53bpump"
}

Response

{
  "success": true,
  "data": {
    "mintAddress": "AVdsFsS45YjGEitb7yQy3XqnNsMVGL3o4cYA53bpump",
    "creatorFound": true,
    "creator": {
      "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "totalTokensCreated": 5
    },
    "reputation": {
      "score": 35,
      "total": 5,
      "rugged": 2,
      "abandoned": 1,
      "failed": 0,
      "active": 2,
      "lowLiquidity": 0,
      "successRate": "40.0",
      "rugRate": "40.0"
    },
    "riskLevel": "HIGH",
    "flags": [
      "⚠️ WARNING - Creator has previous rug pulls",
      "⚠️ HIGH TOKEN COUNT - Creator has launched many tokens",
      "⚠️ MIXED RESULTS - Some tokens succeeded, some failed"
    ],
    "tokens": [
      {
        "mintAddress": "AVdsFsS45YjGEitb7yQy3XqnNsMVGL3o4cYA53bpump",
        "isCurrent": true,
        "hasData": true,
        "status": "active",
        "currentPrice": 0.00012,
        "priceChange24h": 5.3,
        "liquidity": 45000,
        "volume24h": 120000,
        "dexUrl": "https://dexscreener.com/solana/..."
      },
      {
        "mintAddress": "BcdXYZ123...",
        "isCurrent": false,
        "hasData": true,
        "status": "rugged",
        "currentPrice": 0.0000001,
        "priceChange24h": -95.5,
        "liquidity": 50,
        "volume24h": 0
      }
    ]
  }
}

Get Liquidity Lock

Cost: 6¢ per request

SECURITY

Check if token liquidity is locked to prevent rug pulls. Critical for assessing token safety.

POST /api/tools/get_liquidity_lock

Get Whale Activity

Cost: 7¢ per request

SECURITY

Track recent whale transactions and detect accumulation or distribution patterns.

POST /api/tools/get_whale_activity

Get Social Sentiment

Cost: 5¢ per request

SECURITY

Analyze social media presence and detect red flags. Checks Twitter, Telegram, Discord, and website validity.

POST /api/tools/get_social_sentiment

Get Airdrop Check

Cost: 8¢ per request

NEW

Check for unclaimed airdrops and tokens in a wallet. Identifies known airdrops (Jupiter, Jito, Kamino) and potential unclaimed tokens with USD values.

POST /api/tools/get_airdrop_check

Error Handling

Invalid API Key

{
  "success": false,
  "error": "Invalid API key"
}

Rate Limit Exceeded

{
  "success": false,
  "error": "Monthly limit of 100 requests reached"
}

Invalid Parameters

{
  "success": false,
  "error": "Invalid Solana wallet address (must be 44 characters)"
}

Rate Limits

Plan	Monthly Requests	Price
Free	100	$0
Basic	1,000	$10/month
Pro	10,000	$50/month