MCP-Inscription Server is an MCP server that enables AI models to interact with Bitcoin Ordinals inscriptions and extract content directly from transactions. Built to connect AI agents to the Bitcoin blockchain, the server detects and parses transaction data to retrieve digital artifacts stored on-chain. Software developers, cryptocurrency analysts, and Web3 enthusiasts use this server to explore and display various inscription media types, including text, images, and JSON payloads. By acting as a bridge between the Model Context Protocol and the Bitcoin network, the server allows clients like Goose and Claude Desktop to interpret Ordinals without requiring manual transaction decoding or external web explorers. It supports local standard input/output execution as well as standalone network services using Server-Sent Events, making it adaptable to different workflow environments.
Category: Files, Documents & PDFs
Tags: bitcoin, blockchain, inscriptions, ordinals
bash git clone https://github.com/Laz1mov/mcp-inscription cd mcp-inscription npm install npm run build 2. Note the absolute path to the built entry point: /absolute/path/to/mcp-inscription/build/cli.js. 3. To configure in Goose via STDIO, run goose configure or open Settings > Extensions in Goose Desktop. Add a Command-Line Extension with ID mcp-inscription and command node /absolute/path/to/mcp-inscription/build/cli.js. 4. Alternatively, run as an SSE service: bash SERVER_MODE=sse PORT=3000 node build/cli.js Then add a Remote Extension in Goose pointing to http://localhost:3000. 5. To use in Claude Desktop, add the node script command and path under mcpServers in your claude_desktop_config.json.Part of MCP Servers
MCP-Inscription Server is a Model Context Protocol tool that allows AI models to interact with Bitcoin Ordinals inscriptions. It parses Bitcoin transactions to retrieve and display embedded content such as images, text, and JSON directly within AI chat interfaces.
The server explicitly supports Goose through both STDIO local extensions and SSE remote connections. It also integrates with Claude Desktop and other MCP-compatible clients that support launching Node.js scripts over standard input and output.
The server provides the show_ordinals tool, which accepts a Bitcoin transaction identifier, automatically detects and parses the transaction into ordinals, and extracts the associated content for the AI client to read and display.
To run in Server-Sent Events mode, build the repository using npm run build, then execute the command SERVER_MODE=sse node build/cli.js. You can optionally specify a custom listening port by prefixing the command with PORT=your_port.