{"id":27927157,"url":"https://github.com/paulfruitful/walletmcp","last_synced_at":"2026-05-15T21:32:27.816Z","repository":{"id":291486581,"uuid":"977766778","full_name":"paulfruitful/WalletMCP","owner":"paulfruitful","description":"A Simple MCP Server For Interacting With Solana Wallets","archived":false,"fork":false,"pushed_at":"2025-05-05T00:10:31.000Z","size":124,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-05T00:25:53.984Z","etag":null,"topics":["solana","solana-balance-checker","web","web3js"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulfruitful.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-04T23:08:27.000Z","updated_at":"2025-05-05T00:10:35.000Z","dependencies_parsed_at":"2025-05-05T00:35:58.228Z","dependency_job_id":null,"html_url":"https://github.com/paulfruitful/WalletMCP","commit_stats":null,"previous_names":["paulfruitful/walletmcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulfruitful%2FWalletMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulfruitful%2FWalletMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulfruitful%2FWalletMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulfruitful%2FWalletMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulfruitful","download_url":"https://codeload.github.com/paulfruitful/WalletMCP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252795268,"owners_count":21805354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["solana","solana-balance-checker","web","web3js"],"created_at":"2025-05-07T01:28:40.517Z","updated_at":"2026-05-15T21:32:27.785Z","avatar_url":"https://github.com/paulfruitful.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WalletMCP - Solana Blockchain MCP Server\n\nWalletMCP is a Model Context Protocol (MCP) server implementation for interacting with the Solana blockchain. \nIt exposes developer-friendly tools for working with wallets, transactions, program buffers, logs, and SOL transfers through MCP-compatible interfaces.\n\n## 📺 Demo Video\n\n[![WalletMCP Demo](https://img.youtube.com/vi/rq2KudYZCrQ/0.jpg)](https://www.youtube.com/watch?v=rq2KudYZCrQ)\n\u003cbr/\u003e\n*Click the image above to watch the demo video*\n\n## 🧠 Features\n\n- 🔍 Retrieve wallet transactions and SOL balances.\n- 📜 Access program logs from the Solana blockchain.\n- 🧾 Claims Unused Rents (List and close BPF Upgradeable Loader buffers).\n- 💸 Send SOL transactions programmatically.\n- 🧩 Fully MCP-compliant tool definitions using Zod for schema validation.\n\n\n## 🔧 Technologies Used\n\n- **Solana Web3.js SDK** – Solana blockchain interaction\n- **Model Context Protocol (MCP)** – Protocol for tool registration\n- **Zod** – Input validation\n- **TypeScript** – Strong typing and modern tooling\n\n\n## 📋 Requirements\n\n- Node.js v16+\n- Yarn or npm\n\n\n## 🚀 Getting Started\n1. Clone the repository\n   ```bash\n   git clone https://github.com/paulfruitful/WalletMCP\n ```\n\n   ```bash\n   cd walletMCP\n   ```\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Build the MCP Server**\n   ```bash\n   npm run build\n   ```\n## Test The Server:\nTo test the server you can use Claude Desktop MCP Client. Click here to download the desktop application:\n[Download Claude Desktop](https://claude.ai/download)\n\n### For Claude Desktop\nRun the following command this command to open the Claude Desktop Config File\n\n**On Windows**:\n```bash\n   code $env:AppData\\Claude\\claude_desktop_config.json\n\n```\n**On Mac/Linux**:\n```bash\n   code ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n```\nAfter opening the config file, add the server:\n\n```json\n{\n  \"mcpServers\": {\n    \"walletmcp\": {\n      \"command\": \"node\",\n      \"args\": [\n          \"YOUR_PATH_PREFIX\\\\WalletMCP\\\\build\\\\index.js\"\n      ]\n  }\n  }\n}\n```\n\nIt's all set! \nYou can now use the tools provided by the server in Claude Desktop.\nYou can activate these tools on the Claude client by asking questions relating to the Solana wallet.\n\n![Claim Rents Back](./assets/image.png)\n\nQuestions \u0026 Prompts like:\n- \"What are my recent transactions?\"\n\n- \"How much SOL do I have?\"\n\n\n\n- \"How many buffers do I have unused?\"\n- \"Can You send SOL to account [accountAddress]?\"\n- \"What are the logs for a specific program [programId]?\"\n\n\n## ⚙️ Tools \u0026 Their Descriptions\n\n### `getTransactions`\n**Description**: Retrieve recent transactions of a wallet.  \n**Inputs**:\n- `walletAddress` (string)\n- `limit` (number) - maximum number of transactions to fetch.\n\n### `getBalance`\n**Description**: Fetch the SOL balance of a wallet.  \n**Inputs**:\n- `walletAddress` (string)\n\n### `listBuffers`\n**Description**: List program buffers associated with a payer key.  \n**Inputs**:\n- `payerKey` (array of numbers)\n\n### `closeBuffer`\n**Description**: Close a buffer and return lamports to the payer.  \n**Inputs**:\n- `bufferPubkey` (string)\n- `payerKey` (array of numbers)\n\n### `getProgramLogs`\n**Description**: Fetch transaction logs from a specific program ID.  \n**Inputs**:\n- `programId` (string)\n- `limit` (number) - optional, default is 10\n\n### `sendSolTransaction`\n**Description**: Send SOL from one wallet to another.  \n**Inputs**:\n- `fromPrivateKey` (array of numbers)\n- `toPublicKeyStr` (string)\n- `amountSol` (number)\n- `mode` (\"main\" | \"dev\")\n\n\n## 🛡️ Security Considerations\n\n- Always protect your private keys.\n- Keys are not stored or logged in the server\n\n\n\n## 🤝 Contributing\n\nThis project is open to contributions from the Solana dev community.\nIf you have ideas for improvements, feel free to open an issue or submit a pull request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulfruitful%2Fwalletmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulfruitful%2Fwalletmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulfruitful%2Fwalletmcp/lists"}