Labsco
MCP SERVER

MCP-Inscription Server

by Laz1mov

Decodes Ordinals inscriptions out of a Bitcoin transaction's witness data — give it a txid, get the inscribed content back.

Chain State, Explorers & Contract Tooling
Summary
One transaction id in, the inscribed content out.

The surface is a single call, and the interesting work is in what comes back: inscriptions are not one format, so the server decodes text, JSON, HTML and images rather than handing over raw witness bytes. Running it in SSE mode is worth knowing about if several clients should share one instance — the same build serves both modes, selected by an environment variable.

What it is

An MCP server that lets a model read Bitcoin Ordinals inscriptions. It parses the witness data of a transaction and returns whatever was inscribed there, handling text, images, JSON, HTML and other formats.

What you get
  • Inscription decoding from a transaction id, returning the content itself rather than a pointer to it — `show_ordinals`
  • Format handling across text, JSON, HTML and images, with image conversion utilities in the server
  • Two transports in one binary: stdio for a local extension, or SSE mode for running it as a standalone service
Requirements

No account and no key. Clone, `npm install`, `npm run build`, then run `node build/cli.js` — the client needs the absolute path. For the remote path, `SERVER_MODE=sse node build/cli.js` starts it on http://localhost:3000, and `PORT` moves it. There is also a Smithery installer for Claude Desktop. The package is `mcp-inscription` (0.1.0 in package.json).

Setup effort

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