{"id":30354152,"url":"https://github.com/aibtcdev/stacks-mcp-server","last_synced_at":"2025-08-19T02:07:11.782Z","repository":{"id":306682952,"uuid":"1026932922","full_name":"aibtcdev/stacks-mcp-server","owner":"aibtcdev","description":"Model Context Protocol (MCP) server for read-only interaction with Stacks Blockchain","archived":false,"fork":false,"pushed_at":"2025-07-27T00:07:30.000Z","size":56,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-27T03:37:55.713Z","etag":null,"topics":["mcp","mcp-server"],"latest_commit_sha":null,"homepage":"","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/aibtcdev.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,"zenodo":null}},"created_at":"2025-07-26T23:55:11.000Z","updated_at":"2025-07-27T00:07:27.000Z","dependencies_parsed_at":"2025-07-27T03:37:59.351Z","dependency_job_id":null,"html_url":"https://github.com/aibtcdev/stacks-mcp-server","commit_stats":null,"previous_names":["aibtcdev/stacks-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/aibtcdev/stacks-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aibtcdev%2Fstacks-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aibtcdev%2Fstacks-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aibtcdev%2Fstacks-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aibtcdev%2Fstacks-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aibtcdev","download_url":"https://codeload.github.com/aibtcdev/stacks-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aibtcdev%2Fstacks-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271088140,"owners_count":24697081,"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","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["mcp","mcp-server"],"created_at":"2025-08-19T02:07:10.318Z","updated_at":"2025-08-19T02:07:11.771Z","avatar_url":"https://github.com/aibtcdev.png","language":"TypeScript","readme":"# Stacks MCP Server\n\nA Model Context Protocol (MCP) server that provides Stacks blockchain functionality for AI assistants like Claude.\n\n## Tools\n\n### Account Management\n- **`generate_account`** - Generate a new Stacks account with private key\n- **`get_account_balance`** - Check STX balance for any Stacks address\n\n### Blockchain Information  \n- **`get_network_status`** - Get current network status and info\n- **`get_block_info`** - Get block details by height or hash\n- **`get_transaction_info`** - Get transaction details by ID\n- **`search_transactions`** - Search transactions by address\n\n### Configuration\n- **`check_api_status`** - Check API key status and rate limits\n\n## Quick Start\n\n### Using with Claude Desktop\n\nAdd to your Claude Desktop config 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    \"stacks-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"stacks-mcp-server\"],\n      \"env\": {\n        \"STACKS_NETWORK\": \"testnet\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n- **`STACKS_NETWORK`** - Default network: `mainnet`, `testnet`, or `mocknet` (default: `testnet`)\n- **`HIRO_API_KEY`** - Optional API key for higher rate limits ([get one here](https://www.hiro.so/))\n- **`DEBUG`** - Set to `1` for debug logging\n\n### Example with API Key\n\n```json\n{\n  \"mcpServers\": {\n    \"stacks-mcp-server\": {\n      \"command\": \"npx\", \n      \"args\": [\"stacks-mcp-server\"],\n      \"env\": {\n        \"STACKS_NETWORK\": \"testnet\",\n        \"HIRO_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\nOnce configured, you can ask Claude:\n\n- \"Generate a new Stacks testnet account\"\n- \"Check the balance for address ST1ABC...\"  \n- \"Get the latest block info on mainnet\"\n- \"Search for transactions for address ST1XYZ...\"\n- \"What's the current network status?\"\n\n## Networks\n\n- **Testnet**: Safe for development and testing\n- **Mainnet**: Production Stacks network  \n- **Mocknet**: Local development network\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faibtcdev%2Fstacks-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faibtcdev%2Fstacks-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faibtcdev%2Fstacks-mcp-server/lists"}