{"_id":"@claudium/solana-mcp-server","_rev":"2-4e07932d7dca6f33aa9a05910ea5eb89","name":"@claudium/solana-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@claudium/solana-mcp-server","version":"1.0.0","keywords":["mcp","solana","blockchain","solscan","claude","ai","crypto","defi","web3"],"author":{"name":"iclaudiumihaila"},"license":"MIT","_id":"@claudium/solana-mcp-server@1.0.0","maintainers":[{"name":"claudium","email":"iclaudiumihaila@gmail.com"}],"homepage":"https://github.com/iclaudiumihaila/solana-mcp-server#readme","bugs":{"url":"https://github.com/iclaudiumihaila/solana-mcp-server/issues"},"bin":{"solana-mcp":"index.js"},"dist":{"shasum":"bb3aeaf36f4a00226d1e790619581cb65ed0142f","tarball":"https://registry.npmjs.org/@claudium/solana-mcp-server/-/solana-mcp-server-1.0.0.tgz","fileCount":80,"integrity":"sha512-61ughDtwceiBsQEtx4Bd+csxk1NVqzztbkSPo5uOsYbJdVKnmlEW9LyIsPZg2JJYjRlM7SQlyhpbDRny9x6wdw==","signatures":[{"sig":"MEUCIQCI7QITOt03uDx3HjsFh3QeKs0bjifgMnWjG5YZfUbgWAIgZT48SPXWVLUxqq+AxuN3n902yEfg1/2IRAc+6VB41Yo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":519448},"main":"index.js","engines":{"node":">=14.0.0"},"gitHead":"299b0f5c250dacbd8aed997f4146f15fdb778ebd","scripts":{"start":"node index.js","postinstall":"node scripts/setup.js"},"_npmUser":{"name":"claudium","email":"iclaudiumihaila@gmail.com"},"repository":{"url":"git+https://github.com/iclaudiumihaila/solana-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Solana blockchain interaction via Solscan Pro API","directories":{},"_nodeVersion":"22.16.0","dependencies":{"which":"^3.0.1","dotenv":"^16.3.1","cross-spawn":"^7.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/solana-mcp-server_1.0.0_1756816731364_0.1831130986422429","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@claudium/solana-mcp-server","version":"1.0.1","description":"MCP server for Solana blockchain interaction via Solscan Pro API","main":"index.js","bin":{"solana-mcp":"index.js"},"scripts":{"start":"node index.js","postinstall":"node scripts/setup.js"},"keywords":["mcp","solana","blockchain","solscan","claude","ai","crypto","defi","web3"],"author":{"name":"iclaudiumihaila"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/iclaudiumihaila/solana-mcp-server.git"},"bugs":{"url":"https://github.com/iclaudiumihaila/solana-mcp-server/issues"},"homepage":"https://github.com/iclaudiumihaila/solana-mcp-server#readme","engines":{"node":">=14.0.0"},"dependencies":{"cross-spawn":"^7.0.3","dotenv":"^16.3.1","which":"^3.0.1"},"publishConfig":{"access":"public"},"_id":"@claudium/solana-mcp-server@1.0.1","gitHead":"77e292ee9f5665e2e4d86e1dbd9c66fb4af019aa","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-BYm1jCVAPDN42ynUez9GOKvDJZVNTdq2S9pqRZGLDCBliP/F9cek4naWqrpBZeQDDBO6t6lfCs5rBPNOn0F90g==","shasum":"70f1acef78082307711f1101848c5d42d6d39f37","tarball":"https://registry.npmjs.org/@claudium/solana-mcp-server/-/solana-mcp-server-1.0.1.tgz","fileCount":79,"unpackedSize":517457,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICqqEgQ+9bdHeuNAyqV7pMur0pGo8yAO0lXv0bApuisuAiASCCq4l54A+pdZwYjFoTOX6xqtgphoyrr7ga9F2LTmIQ=="}]},"_npmUser":{"name":"claudium","email":"iclaudiumihaila@gmail.com"},"directories":{},"maintainers":[{"name":"claudium","email":"iclaudiumihaila@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/solana-mcp-server_1.0.1_1756817286821_0.7066810487956467"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-02T12:38:51.244Z","modified":"2025-09-02T12:48:07.180Z","1.0.0":"2025-09-02T12:38:51.545Z","1.0.1":"2025-09-02T12:48:07.012Z"},"bugs":{"url":"https://github.com/iclaudiumihaila/solana-mcp-server/issues"},"author":{"name":"iclaudiumihaila"},"license":"MIT","homepage":"https://github.com/iclaudiumihaila/solana-mcp-server#readme","keywords":["mcp","solana","blockchain","solscan","claude","ai","crypto","defi","web3"],"repository":{"type":"git","url":"git+https://github.com/iclaudiumihaila/solana-mcp-server.git"},"description":"MCP server for Solana blockchain interaction via Solscan Pro API","maintainers":[{"name":"claudium","email":"iclaudiumihaila@gmail.com"}],"readme":"# Solana MCP Server\n\nA comprehensive MCP (Model Context Protocol) server for interacting with the Solana blockchain through natural language. Powered by Solscan Pro API v2.0 with support for multiple data providers.\n\n## Features\n\n- **🚀 Comprehensive Blockchain Data**: Access token prices, wallet portfolios, DeFi activities, and more\n- **📊 Solscan Pro API Integration**: Professional-grade data with high reliability\n- **🔄 Multiple Data Providers**: Fallback support with DexScreener and Jupiter\n- **⚡ Smart Caching**: Reduces API calls and improves response time\n- **🛡️ Error Handling**: Graceful error handling with user-friendly messages\n- **🧮 Trading Tools**: Built-in calculator for profit/loss, position sizing, etc.\n- **🔥 NPM Package**: Easy installation via NPM registry\n\n## Installation\n\n### Prerequisites\n- Python 3.8 or higher\n- Node.js 14 or higher (for NPM installation)\n- Solscan Pro API key (get one at https://pro-api.solscan.io/)\n\n### Install via NPM (Recommended)\n\n```bash\nnpx @claudium/solana-mcp-server@latest\n```\n\n### Install from Source\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/yourusername/solana-mcp-server.git\ncd solana-mcp-server\n```\n\n2. **Install dependencies**\n```bash\npip install -e .\n```\n\n3. **Configure API key**\n```bash\ncp .env.example .env\n# Edit .env and add your SOLANA_API_KEY\n```\n\n4. **Add to Claude Desktop**\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"solana\": {\n      \"command\": \"python\",\n      \"args\": [\"/path/to/solana-mcp-server/server.py\"],\n      \"env\": {\n        \"SOLANA_API_KEY\": \"your_solscan_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n5. **Restart Claude Desktop**\n\n## Available Tools\n\n### 🪙 Token Operations\n\n#### Get Token Info\nGet comprehensive token data including price, market cap, holders, and liquidity.\n```\n\"What's the price of USDC?\"\n\"Get info for token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n```\n\n#### Get Token Prices\nGet current prices for single or multiple tokens.\n```\n\"Get price for [token_address]\"\n\"Get prices for multiple tokens: [address1, address2, address3]\"\n```\n\n#### Find Trending Tokens\nDiscover trending and popular tokens on Solana.\n```\n\"Show me trending tokens on Solana\"\n\"What are the top gaining tokens today?\"\n```\n\n### 👛 Wallet/Account Operations\n\n#### Get Wallet Portfolio\nComplete portfolio analysis with token balances and values.\n```\n\"Show portfolio for wallet [address]\"\n\"What tokens does [wallet_address] hold?\"\n```\n\n#### Get Wallet Transactions\nView transaction history for any wallet.\n```\n\"Show recent transactions for [wallet]\"\n\"Get transaction history for [address]\"\n```\n\n#### Get DeFi Activities\nTrack DeFi positions and activities.\n```\n\"Show DeFi activities for [wallet]\"\n\"What yield farms is [address] in?\"\n```\n\n### 🧮 Trading Calculator\n\nPerform various trading calculations:\n- **Profit/Loss**: Calculate P&L with fees\n- **Position Sizing**: Risk management calculations\n- **Price Targets**: Calculate multiplier targets\n- **Price Impact**: Estimate slippage\n\n```\n\"Calculate profit if I buy at 0.01 and sell at 0.05 with 1000 tokens\"\n\"What's the position size with $10000 capital and 2% risk?\"\n```\n\n## API Key Configuration\n\nThe server requires a Solscan Pro API key. You can provide it in several ways:\n\n1. **Environment Variable** (Recommended for development)\n```bash\nexport SOLANA_API_KEY=your_key_here\n```\n\n2. **In .env file** (Recommended for persistent setup)\n```\nSOLANA_API_KEY=your_key_here\n```\n\n3. **In Claude config** (Recommended for Claude Desktop)\n```json\n\"env\": {\n  \"SOLANA_API_KEY\": \"your_key_here\"\n}\n```\n\n## Project Structure\n\n```\nsolana-mcp-server/\n├── server.py           # Main MCP server\n├── providers/          # Data provider integrations\n│   ├── solscan/       # Solscan Pro API client\n│   ├── dexscreener.py # DexScreener integration\n│   └── jupiter.py     # Jupiter aggregator\n├── tools/             # MCP tool implementations\n│   ├── token/         # Token-related tools\n│   ├── account/       # Wallet/account tools\n│   ├── defi/          # DeFi analytics\n│   └── market/        # Market data tools\n└── utils/             # Utility functions\n    ├── cache.py       # Caching system\n    └── formatter.py   # Response formatting\n```\n\n## Development\n\n### Running Tests\n```bash\npython -m pytest tests/\n```\n\n### Adding New Tools\n1. Create a new file in `tools/` directory\n2. Inherit from `BaseTool` class\n3. Implement `name`, `description`, and `execute` methods\n4. Register in `server.py`\n\n### Contributing\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Error Handling\n\nThe server includes comprehensive error handling:\n- API failures gracefully fallback to cached data\n- User-friendly error messages\n- Automatic retries for transient failures\n- Rate limiting protection\n\n## Caching Strategy\n\n- Token prices: 30 seconds TTL\n- Account data: 60 seconds TTL\n- Trending tokens: 5 minutes TTL\n- Historical data: 10 minutes TTL\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/yourusername/solana-mcp-server/issues)\n- **Documentation**: [API Docs](https://pro-api.solscan.io/pro-api-docs/v2.0/reference)\n- **Get API Key**: [Solscan Pro](https://pro-api.solscan.io/)\n\n## Disclaimer\n\nThis tool requires a Solscan Pro API key for full functionality. Some features may be limited without proper API access. Always verify critical financial data from multiple sources.","readmeFilename":"README.md"}