doge-mcp

Paid Model Context Protocol server for the Dogecoin / Dogenals ecosystem.

AI agents and developers query live indexed Doginals, Dunes, DRC-20, ÐMP, Treats, ÐLotto, etc. through a clean MCP interface. Indexer operators running dogex get paid for serving the data.

Part of the Dogenals + dogex stack.

Why this exists

• dogex is the deterministic chain-truth + metaprotocol indexer.

• Multiple independent operators can run dogex and stay in sync (federation fingerprint).

• AI agents should not get high-value index data for free.

• MCP + micropayments (x402) is the cleanest way to charge agents per tool call in 2026.

This server is the first public surface that turns “running a dogex indexer” into a revenue activity while keeping the open standards free.

Quick start (local / free tier)

git clone https://github.com/jonheaven/doge-mcp.git
cd doge-mcp
npm install
npm run build

# Point at a running dogex instance
export DOGEX_URL=http://127.0.0.1:8080   # or https://dogex.command.dog etc.

npm start

Add to Claude Desktop / Cursor MCP config:

{
  "mcpServers": {
    "doge-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/doge-mcp/dist/index.js"],
      "env": {
        "DOGEX_URL": "https://your-dogex-instance.example.com"
      }
    }
  }
}

Or run via npx once published.

Current tools (v0.1)

More tools (PSBT helpers, range queries, proofs, analytics) will be added as dogex endpoints solidify.

Paid model (roadmap)

1. v0.1 (now) — Working MCP that talks to any dogex instance. Free for basic tools.

2. v0.2 — Wrap high-value tools with x402 (paidTool). Agents pay in USDC (Base) or later DOGE-native rails. Operators set their own recipient address.

3. v0.3+ — Multi-operator discovery + federation-aware routing. Agents prefer healthy, matching-fingerprint indexers. Revenue stays with the runner who served the query (optional small protocol fee).

Standards (dogenals/spec) stay free and public. You are selling live indexed state + computation, not the rules.

Environment

Development

npm run dev          # tsx watch
npm run typecheck
npm run build

Related

• dogenals — normative standards & docs

• dogex — Rust node + deterministic indexer (chain truth)

• x402 — open micropayment protocol for agents

Much paid. Very index. Wow.