MCP-Inscription Server

A Model Context Protocol (MCP) server that enables AI models to interact with Ordinals Inscriptions, allowing them to display content from a transaction.

- Ordinal Detection: Automatically detect and parse Bitcoin transaction into ordinals, supporting text-based, images, json and more inscriptions formats.

Goose is an open-source AI agent framework by Block that supports extensions via the Model Context Protocol. You can integrate the MCP-Inscription server as a Goose extension to allow Goose to interact with Ordinals Inscriptions. Goose supports two modes of integration for MCP servers: running the server as a local process (STDIO) or connecting to it as a remote service via Server-Sent Events (SSE). Below are instructions for both methods:

This method runs the MCP-Inscription server locally as a subprocess of Goose, communicating through standard input/output.
-

Clone and Build the MCP-Inscription Repository (if you haven't already):

git clone https://github.com/Laz1mov/mcp-inscription cd mcp-inscription npm install npm run build

Note the full absolute path to the repository, as you'll need it in the next step.

Enter the extension details:Provide a name and command for the MCP-Inscription server:

Name:You can call it "mcp-inscription", or any identifier (this will be how you refer to the extension).

Command:Specify the full path to the built CLI script. For example:

node /absolute/path/to/mcp-inscription/build/cli.js

Replace/absolute/path/to/mcp-inscriptionwith the actual path to where you cloned the repository.

You typically do not need to add any arguments beyond the script path (unless your server requires special flags).

Start a Goose session with the new extension:You can now use the extension in Goose. If you're running Goose via CLI, start a session that includes the extension by running:

goose session --with-extension "mcp-inscription"

This method connects Goose to an already-running MCP server via an HTTP SSE stream. Use this if you want to run the MCP-Inscription server as a standalone service (possibly on another machine or just independently of Goose).
-

Launch the MCP server as a standalone service:Run the MCP-Inscription server in SSE mode to listen for connections:

# Navigate to your mcp-inscription directory cd /path/to/mcp-inscription # If you havent built it yet npm install npm run build # Run in SSE mode on port 3000 (default) SERVER_MODE=sse node build/cli.js # Alternatively, specify a different port SERVER_MODE=sse PORT=9000 node build/cli.js

This will start the server in SSE mode, making it available athttp://localhost:3000(or your specified port).

Enter the remote extension details:Give the extension a name (e.g., "ordinals") and provide the server's URL. For theURL, enter the base address where the MCP server is running. For instance, if your server is listening on port 9000 on your local machine, you might enterhttp://localhost:9000. Goose will attempt to connect to the MCP server's SSE endpoint at that address. (Goose uses the standard MCP SSE path, which by convention is under the/mcp/sseroute on the server, you usually just need to supply the host and port, and Goose handles the rest.)

Enable the extension:After adding the remote extension, ensure it's enabled in Goose's settings (just like in the STDIO case). Only one of the STDIO or SSE extension (with the same tools) needs to be enabled – if you accidentally enable both a local and remote version of the same server, you may want to disable one to avoid confusion.

Using the MCP-Inscription extension in Goose:Once the extension is set up (via either method above) and enabled, you can interact with Goose and query ord data through it. In a new Goose chat or session, simply ask questions as you normally would. Goose will recognize when to use the MCP-Inscription tools to fulfill your request. For example:

- "Show me Ordinals: 0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389?"

When you ask these questions, Goose will invoke the MCP-Inscription server's tools and return the answer (e.g., the latest Bitcoin block information). You should see Goose responding with up-to-date information pulled from the Bitcoin blockchain via the MCP-Inscription server.

If Goose does not seem to use the extension (for instance, if it responds that it cannot find the information), make sure the extension is enabled and that the server is running (in SSE mode for remote). You can also run Goose's CLI with verbose logging to see if it attempted to call the extension. Generally, if configured correctly, Goose will automatically discover the MCP-Inscription server's capabilities and use them when relevant.

To use the MCP-Inscription server with Claude Desktop (Anthropic's desktop app for Claude), follow these steps:
-

Clone and Build the MCP-Inscription Repository:

git clone https://github.com/Laz1mov/mcp-inscription cd mcp-inscription npm install npm run build

Configure Claude Desktop to use the MCP-Inscription Server:Open the Claude Desktop configuration file (it's created when you first edit settings in Claude Desktop):

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
Add an entry for the MCP-Inscription server in this JSON config under the"mcpServers"section. For example:

npx -y @smithery/cli install @Laz1mov/mcp-inscription --client claude

mcp-inscription/ ├── src/ │ ├── ordinals_client.ts # Bitcoin ordinals and runestone utility functions │ ├── servers/ │ │ ├── index.ts # Server exports and factory functions │ │ ├── sse.ts # Server implementation using SSE transport │ │ ├── stdio.ts # Server implementation using STDIO transport │ │ └── base.ts # Base server implementation with shared functionality │ ├── index.ts # Main entry point │ ├── cli.ts # CLI launcher │ ├── mcp_inscription_types.ts # Shared types and schemas for the MCP-Inscription server │ └── utils/ │ ├── logger.ts # Logger setup │ ├── cache.ts # Caching implementation │ ├── error_handlers.ts # Error handling utilities │ ├── json_utils.ts # JSON processing utilities │ ├── img_utils.ts # Image processing and conversion utilities │ └── version.ts # Version information ├── .env.example # Example environment configuration file ├── package.json ├── tsconfig.json └── README.md

Description:
Decodes Ordinal inscription data from a transaction's witness data.

{ "txid": "string" }

{ "txid": "0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389" }

Output:
Returns the decoded inscription content, which may be text, JSON, HTML, or other formats.

The server employs custom error types to handle Bitcoin operations and blockchain queries. Detailed error messages are logged using Pino and included in client responses for easier debugging.

Contributions and feature requests are welcome! Feel free to submit pull requests or open issues on GitHub.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Access real-time and historical crypto market data from CoinAPI’s MCP server, built for developers and AI agents needing reliable, unified market coverage.

50+ pay-per-call APIs for AI agents via HTTP 402 crypto micropayments. $0.001–$0.12 per call with USDC and USDm.

Interact with Alchemy's blockchain APIs to query data without writing code.

An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.

Provides real-time access to Chainlink's decentralized on-chain price feeds.

Formo makes analytics and attribution easy for crypto apps, so you can focus on growth. Measure what matters and drive growth onchain with the data platform for onchain apps. Get the best of web, product, and onchain analytics on one versatile platform.

Provides real-time crypto and Web3 intelligence using the Hive Intelligence API.

Provides real-time cryptocurrency pricing data and market information from major exchanges like Binance, Coinbase, and Kraken via the Luzia API. It enables AI assistants to fetch ticker prices, compare exchange rates, and analyze market trends through specialized tools and prompts.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.