{"id":28192916,"url":"https://github.com/dcspark/mcp-cryptowallet-evm","last_synced_at":"2025-06-18T13:34:44.100Z","repository":{"id":280715629,"uuid":"942918420","full_name":"dcSpark/mcp-cryptowallet-evm","owner":"dcSpark","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-26T03:12:14.000Z","size":315,"stargazers_count":2,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-28T17:51:56.537Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dcSpark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-03-04T22:14:59.000Z","updated_at":"2025-03-26T03:12:17.000Z","dependencies_parsed_at":"2025-03-04T23:30:36.743Z","dependency_job_id":"28105310-514f-4756-b28b-7375cbcb75bc","html_url":"https://github.com/dcSpark/mcp-cryptowallet-evm","commit_stats":null,"previous_names":["dcspark/mcp-cryptowallet-evm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fmcp-cryptowallet-evm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fmcp-cryptowallet-evm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fmcp-cryptowallet-evm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fmcp-cryptowallet-evm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dcSpark","download_url":"https://codeload.github.com/dcSpark/mcp-cryptowallet-evm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254527097,"owners_count":22085920,"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":[],"created_at":"2025-05-16T12:15:45.211Z","updated_at":"2025-05-16T12:16:03.904Z","avatar_url":"https://github.com/dcSpark.png","language":"TypeScript","funding_links":[],"categories":["Finance \u0026 Fintech"],"sub_categories":["How to Submit"],"readme":"# MCP Crypto Wallet EVM\n\nThis repository contains a Model Context Protocol (MCP) server that provides Claude with access to Ethereum and EVM-compatible blockchain operations via ethers.js v5. The server enables Claude to perform operations like creating wallets, checking balances, sending transactions, and interacting with smart contracts on EVM-compatible blockchains.\n\n\u003ca href=\"https://glama.ai/mcp/servers/@dcSpark/mcp-cryptowallet-evm\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@dcSpark/mcp-cryptowallet-evm/badge\" alt=\"Crypto Wallet EVM MCP server\" /\u003e\n\u003c/a\u003e\n\n## Overview\n\nThe MCP server exposes the following tools to Claude:\n\n### Wallet Creation and Management\n- `wallet_create_random`: Create a new wallet with a random private key\n- `wallet_from_private_key`: Create a wallet from a private key\n- `wallet_from_mnemonic`: Create a wallet from a mnemonic phrase\n- `wallet_from_encrypted_json`: Create a wallet by decrypting an encrypted JSON wallet\n- `wallet_encrypt`: Encrypt a wallet with a password\n\n### Wallet Properties\n- `wallet_get_address`: Get the wallet address\n- `wallet_get_public_key`: Get the wallet public key\n- `wallet_get_private_key`: Get the wallet private key (with appropriate security warnings)\n- `wallet_get_mnemonic`: Get the wallet mnemonic phrase (if available)\n\n### Blockchain Methods\n- `wallet_get_balance`: Get the balance of the wallet\n- `wallet_get_chain_id`: Get the chain ID the wallet is connected to\n- `wallet_get_gas_price`: Get the current gas price\n- `wallet_get_transaction_count`: Get the number of transactions sent from this account (nonce)\n- `wallet_call`: Call a contract method without sending a transaction\n\n### Transaction Methods\n- `wallet_send_transaction`: Send a transaction\n- `wallet_sign_transaction`: Sign a transaction without sending it\n- `wallet_populate_transaction`: Populate a transaction with missing fields\n\n### Signing Methods\n- `wallet_sign_message`: Sign a message\n- `wallet_sign_typed_data`: Sign typed data (EIP-712)\n- `wallet_verify_message`: Verify a signed message\n- `wallet_verify_typed_data`: Verify signed typed data\n\n### Provider Methods\n- `provider_get_block`: Get a block by number or hash\n- `provider_get_transaction`: Get a transaction by hash\n- `provider_get_transaction_receipt`: Get a transaction receipt\n- `provider_get_code`: Get the code at an address\n- `provider_get_storage_at`: Get the storage at a position for an address\n- `provider_estimate_gas`: Estimate the gas required for a transaction\n- `provider_get_logs`: Get logs that match a filter\n- `provider_get_ens_resolver`: Get the ENS resolver for a name\n- `provider_lookup_address`: Lookup the ENS name for an address\n- `provider_resolve_name`: Resolve an ENS name to an address\n\n### Network Methods\n- `network_get_network`: Get the current network information\n- `network_get_block_number`: Get the current block number\n- `network_get_fee_data`: Get the current fee data (base fee, max priority fee, etc.)\n\n## Prerequisites\n\n- Node.js (v16 or higher)\n- Claude Desktop application\n\n## Installation\n\n### Option 1: Using npx (Recommended)\n\nYou can run the MCP server directly without installation using npx:\n\n```bash\nnpx @mcp-dockmaster/mcp-cryptowallet-evm\n```\n\nThis will download and execute the server directly from npm.\n\n### Option 2: Manual Installation\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/dcSpark/mcp-cryptowallet-evm.git\n   cd mcp-cryptowallet-evm\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm ci\n   ```\n\n3. Build the project:\n   ```bash\n   npm run build\n   ```\n\n## Configuration\n\n### Environment Variables\n\nThe MCP server supports the following environment variables:\n\n- `PRIVATE_KEY`: Optional private key to use for wallet operations when no wallet is explicitly provided\n\n### Configure Claude Desktop\n\nTo configure Claude Desktop to use this MCP server:\n\n1. Open Claude Desktop\n2. Navigate to the Claude Desktop configuration file:\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - Linux: `~/.config/Claude/claude_desktop_config.json`\n\n3. Add the MCP server configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-cryptowallet-evm\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@mcp-dockmaster/mcp-cryptowallet-evm\"\n      ]\n    }\n  }\n}\n```\n\nAlternatively, if you installed the package locally:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-cryptowallet-evm\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/your/mcp-cryptowallet-evm/build/index.js\"\n      ]\n    }\n  }\n}\n```\n\n### Running Locally\n\n```bash\nnode build/index.js\n```\n\n## Usage\n\nOnce configured, restart Claude Desktop. Claude will now have access to the Ethereum and EVM-compatible blockchain tools. You can ask Claude to:\n\n1. Create a new wallet:\n   ```\n   Can you create a new Ethereum wallet for me?\n   ```\n\n2. Check a wallet balance:\n   ```\n   What's the balance of the Ethereum wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?\n   ```\n\n3. Send a transaction:\n   ```\n   Can you help me send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?\n   ```\n\nClaude will use the MCP server to interact with the Ethereum blockchain directly.\n\n## Development\n\n### Adding New Tools\n\nTo add new tools to the MCP server:\n\n1. Define the tool in `src/tools.ts`\n2. Create a handler function in the appropriate handler file\n3. Add the handler to the `handlers` object in `src/tools.ts`\n\n### Building\n\n```bash\nnpm run build\n```\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcspark%2Fmcp-cryptowallet-evm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdcspark%2Fmcp-cryptowallet-evm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcspark%2Fmcp-cryptowallet-evm/lists"}