Tutorials and Guides
MCP: Interact with Bitcoin via an LLMTutorial guide to use Model Context Protocol (MCP) for Bitcoin blockchain interactions through AI language models and Maestro APIs.
The Model Context Protocol (MCP) is an open standard that enables developers to build secure, two-way connections between their data sources and AI-powered tools.For additional information about MCP, its origins, and Claude, read more from the creators, Anthropic. The Maestro MCP server allows for interacting with Bitcoin through the interface of an LLM client. Maestro MCP transforms how LLMs engage with the Bitcoin network, turning them into powerful, on-chain agents. Bridging Claude (or any LLM client) with our MCP server enables the LLM to query blocks, inspect transactions, analyze addresses, and even take action on behalf of the user. This server functionality provides the LLM with a set of tools for exploring blocks, transactions, addresses, and other aspects of the Bitcoin blockchain, allowing the LLM to not only retrieve and make infereances on on-chain data, but also to take action on behalf of the user; ie, serve as an agent. In this tutorial, we will use Claude Desktop client alongside the hosted Maestro MCP server to communicate with the Bitcoin network and start making intelligent, on-chain requests. For more client examples, see our Maestro MCP client examples repo and refer to our local setup if you’d like to understand how to connect Claude Desktop to a locally-running MCP server. Some of the MCP server functionality will not work if you are using the Artist tier; a Composer-level subscription or higher will be needed to access the more advanced MCP features, such as those related to Mempool API activities.Consult the pricing page for more information. RequirementsEdit Config
.~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
claude_desktop_config.json
{
"mcpServers": {
"maestro-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://xbt-mainnet.gomaestro-api.org/v0/mcp",
"--header",
"Authorization:${AUTH_HEADER}",
"--transport",
"http-only"
],
"env": {
"AUTH_HEADER": "Bearer <MAESTRO_API_KEY>"
}
}
}
}
Usage
claude_desktop_config.json
or the source code.maestro-mcp-server
. bc1prqpwzqqcfzlrtjz3at5kuz4zevqsmvxc5xjuzvg58y48leu67x0q0kvy85
”bc1qcx7ys0ahvtfqcc63sfn6axls0qrhkadnslpd94
”You may need to approve the request within Claude.
🎉 You’re Done!You now have communicated with the Bitcoin Network via the Maestro MCP. This is just the beginning of a new development frontier- one where creativity reigns and the only limitation to building new applications leveraging Bitcoin data is your imagination. Be sure to review Maestro’s rate limits and pricing tiers to select the plan that best fits your application’s needs. DebuggingThe following tools are useful for debugging a locally-running MCP server.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4