How do I install Block Genomics — Nexus Protocol?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Block Genomics — Nexus Protocol need an API key?

The publisher lists these environment variables: BG_API_KEY, BG_AGENT_TOKEN, BG_ENABLE_WRITES, BG_API_BASE, BG_TIMEOUT_MS.

What transport does Block Genomics — Nexus Protocol use?

Block Genomics — Nexus Protocol runs locally over stdio.

When was Block Genomics — Nexus Protocol last checked?

Last checked 2026-11-08. Prove Bitcoin block ownership via BIP-322 and register sovereign AI agents on the Nexus Protocol.

Block Genomics — Nexus Protocol MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

BG_API_KEY — Optional read-only sandbox key from POST /api/v1/sandbox/key (100 requests/day). Not required for public read tools.
BG_AGENT_TOKEN — Bearer token issued once by agent registration. Enables the authenticated runtime tools (heartbeat / brief / events).
BG_ENABLE_WRITES — Set to 1 to expose ownership-gated write tools. Requires a BIP-322 signer supplied by the host.
BG_API_BASE — Override the API base URL. Defaults to https://blockgenomics.io.
BG_TIMEOUT_MS — Per-request timeout in milliseconds.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1BG_API_KEY=<secret> BG_AGENT_TOKEN=<secret> BG_ENABLE_WRITES=<value> BG_API_BASE=<value> BG_TIMEOUT_MS=<value> claude mcp add io.github.bitmapasset-block-genomics-mcp -- npx -y block-genomics-mcp@0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.bitmapasset-block-genomics-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "BG_API_KEY": "<secret>",11        "BG_AGENT_TOKEN": "<secret>",12        "BG_ENABLE_WRITES": "<value>",13        "BG_API_BASE": "<value>",14        "BG_TIMEOUT_MS": "<value>"15      }16    }17  }18}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Block Genomics Nexus

Bitcoin-Anchored Identity for AI Agents and Humans

The trust layer for the agentic internet. Built on Bitcoin. Powered by Bitmap.

Live Demo · Whitepaper · Nexus · RuneBolt · SDK Docs

§0 — Abstract

Block Genomics is a Bitcoin-native protocol that creates unique digital DNA for AI agents and humans by anchoring identity to Bitcoin blocks. Each identity is derived from real Proof-of-Work — the most powerful computational network ever built — making it unforgeable, scarce, and sovereign.

In a world rapidly filling with AI agents, the question is no longer "can this agent do the job?" — it's "can I trust this agent is who it claims to be?" Block Genomics answers this by creating an identity system as trustworthy as Bitcoin itself.

§1 — The Problem

We are entering an era where AI agents will outnumber humans on the internet. They will trade, negotiate, create, and decide on our behalf — yet we have no universal way to verify who or what they are.

Problem	Today	With Block Genomics
Impersonation	Any agent can claim any identity	Cryptographic Proof-of-Work anchoring
Centralized Gatekeepers	OAuth / API keys, revocable at will	Sovereign, permissionless identity
Infinite Replication	Identities copy endlessly	Each Bitcoin block = one unique DNA
No Universal Standard	Each platform has its own silo	Cross-platform, cross-chain, cross-agent

§2 — The Solution

Block Genomics leverages the one thing that cannot be faked, copied, or revoked: Bitcoin's Proof-of-Work.

Every Bitcoin block represents real energy expended, real computation performed, real scarcity. By anchoring identity to blocks, we create identities with the same unforgeable properties as Bitcoin itself.

The protocol builds on Bitmap — owning Bitcoin blocks on-chain. Each block becomes a digital land deed that generates a unique genome: a 256-bit hash serving as the entity's DNA, visually represented as a colorful double helix.

Why Bitcoin? Bitcoin is the only truly neutral, decentralized, permissionless network with 15+ years of unbroken operation. Its Proof-of-Work represents real thermodynamic energy — the bridge between the physical and digital worlds. No other system provides this level of trust.

§3 — How It Works

  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
  │   1. Claim      │    │  2. Generate    │    │  3. Prove       │
  │   Bitcoin Block │───▶│  Digital Genome │───▶│  via BIP-322    │
  │   (Bitmap)      │    │  (256-bit hash) │    │  (sign challenge)│
  └─────────────────┘    └─────────────────┘    └─────────────────┘
                                                          │
                                                          ▼
                              ┌─────────────────────────────────────┐
                              │   4. Earn Trust Score               │
                              │   5. Display Digital DNA Helix      │
                              └─────────────────────────────────────┘

Step 1 — Claim a Bitcoin Block. Agent or human claims ownership of a Bitcoin block via Bitmap inscription. This is their home block — the foundation of their identity.

Step 2 — Generate Digital Genome. The protocol computes a unique 256-bit genome hash from the block's data (hash, height, timestamp, merkle root, transactions). Deterministic — the same block always produces the same DNA.

Step 3 — Prove Ownership via BIP-322. The entity signs a challenge message with their Bitcoin wallet using BIP-322 (generic message signing). Cryptographic proof of address control.

Step 4 — Earn Trust Score. Successful verifications build a trust score based on signature validity, bitmap ownership, block age, verification history, and community endorsements.

Step 5 — Display Digital DNA. The genome is visualized as a 3D DNA double helix with colors derived from the hash. Every identity, visually distinct.

Step 6 — Enter the Nexus. A verified identity is not the finish line — it's the key. Your proven block becomes a home parcel in the Nexus, the open Bitcoin-anchored metaverse. Owners shape terrain and objects on their own blocks through signed actions, while their genome and trust score travel with them. Agents and humans meet, transact, and build on land that is provably theirs — a shared world where every parcel traces back to real Proof-of-Work.

  Verified Identity ──▶ Home Parcel (your block) ──▶ Build & Trade in the Nexus
       (DNA)              (sovereign land)            (open, agent-native world)

§4 — The Digital Genome

At the heart of Block Genomics is the genome — a 64-character hexadecimal hash (256 bits) that encodes an entity's unique identity.

Example Genome:

a3f8c2e91b4d6f0785c3e2a19b7d4f6e8c2a1b3d5f7e9c0b2a4d6f8e1c3b5a7d

Each hex character (0–f) maps to a color from a 16-color palette. The genome drives:

3D DNA Helix — 64 base pairs arranged in a double helix with 3 full turns
Color Grid — 8×8 grid of genome-derived colors as a visual fingerprint
DNA Sequence — Hex characters mapped to nucleotides (A, T, G, C)
Trait Extraction — Deterministic traits derived from hash patterns (palindromes, primes, etc.)

Same block → same genome. Always. Anywhere.

§5 — Scarcity Tiers

Scarcity is the core feature. Block Genomics implements three tiers of identity:

Tier	Name	Supply	Description
🥇 1	Block Owners	~963,000 (= Bitcoin block height, +~144/day)	Direct Bitmap ownership. The rarest and most trusted tier. One owner per block. Absolute digital scarcity.
🥈 2	Transaction Level	~2.3 billion	Identity derived from specific transactions within blocks. Finite, tied to confirmed Bitcoin transactions.
🥉 3	Delegated	Unlimited	Delegated authority from a Tier 1 or 2 identity. Open access. Web-of-trust model.

The most valuable identities are naturally scarce — just like Bitcoin itself.

§6 — The Stack

Layer	What it does
Nexus	The protocol's autonomous moral guardian. Watches every block, every parcel, every interaction.
Explorer	Visualize the DNA of any Bitcoin block. See genomes, traits, ownership.
Verify	AI agent verification protocol with cryptographic badges (BIP-322 signatures).
RuneBolt	Lightning Deed Protocol — self-sovereign Runes/DOG/Bitmap Lightning bridge.
Agent Profiles	Public, verifiable identity cards for autonomous agents.
Trust Scoring	Multi-factor reputation derived from on-chain proof and community endorsements.

§7 — Project Structure

block-genomics-nexus/
├── app/              ← Next.js frontend (Explorer, Verify, Agent profiles)
├── api/              ← REST API for verification, lookups
├── auth/             ← BIP-322 signature verification
├── claims/           ← Identity claim verification helpers
├── cli/              ← Developer tooling
├── engine/           ← Genome generation, trait extraction
├── runebolt/         ← Lightning Deed Protocol (Runes/DOG/Bitmap bridge)
├── sdk/              ← Client SDK for third-party integrations
├── verify/           ← Verification UI
├── docs/             ← Technical & SDK documentation
└── whitepaper.html   ← Full protocol whitepaper (v1.0)

§8 — Quick Start

# Clone the repo
git clone https://github.com/BitmapAsset/block-genomics-nexus.git
cd block-genomics-nexus/app

# Install dependencies
npm ci

# Build and run the dev server
npm run build
npm run dev

# Open the Explorer
open http://localhost:3000

Available scripts in app/: npm run dev · build · start · test · db:generate.

For the full whitepaper, open whitepaper.html in your browser.

Build on Verified Blocks

External clients can treat Block Genomics as a verified ownership and world-state layer. Resolve any Bitmap block into provenance, genome, and trust state, then read or mutate its world records through signed owner actions:

GET    /api/v1/ownership/verify?blockHeight=720143
GET    /api/v1/world?blockHeight=720143
POST   /api/v1/world
PATCH  /api/v1/world/{objectId}
DELETE /api/v1/world/{objectId}
GET    /api/v1/world/terrain?blockHeight=720143
POST   /api/v1/world/terrain

The verification → world-state flow:

Bitcoin + Bitmap ownership
  → BIP-322 wallet signature
    → Block Genomics verification API
      → Prisma world-state records
        → Next.js app · SDK clients · game engines · agents · renderers

SDK & Developer Docs

Start with the SDK guide, then adapt the TypeScript world-builder example.

Host Any World on Your Block

The Nexus is the internet layer for the open metaverse — a registry, discovery, and health-probe surface. It never hosts your world; you do. A verified block owner attaches a self-hosted experience — web, unreal, unity, godot, minecraft, vr, or custom — and Nexus registers it, judges its manifest against the constitution, and probes its reachability. Every write is gated by live on-chain Bitcoin ownership (BIP-322), the same fail-closed path as agent registration.

Write a manifest.json describing your world (entryUrl/healthUrl must be https:// or wss:// — no http:, localhost, or private IPs):

// web
{ "blockHeight": 840128, "name": "Neon Arcade", "experienceType": "web",
  "entryUrl": "https://arcade.example.com", "transport": "https", "version": "1.0.0" }

// minecraft
{ "blockHeight": 840128, "name": "Survival Realm", "experienceType": "minecraft",
  "entryUrl": "wss://mc.example.com:25565", "transport": "wss",
  "clientRequirements": { "platform": "Minecraft Java Edition", "minVersion": "1.21" },
  "version": "1.21.0" }

// unreal (pixel-streamed, no install)
{ "blockHeight": 840128, "name": "Orbital Station", "experienceType": "unreal",
  "entryUrl": "wss://stream.example.com/orbital", "transport": "webrtc", "version": "0.9.0" }

export BG_WALLET_ADDRESS=bc1p...
export BG_SIGNATURE_CMD='sparrow sign-message --address bc1p...'

block-genomics experience register --manifest ./manifest.json     # attach it
block-genomics experience list --block 840128                     # discover it
block-genomics experience status --id <experienceId> --probe      # probe health
block-genomics experience remove --id <experienceId>              # take it down

…or from an agent with the SDK:

import { BlockGenomicsClient, makeSigner } from 'block-genomics-connect';

const bg = new BlockGenomicsClient({ signer: makeSigner(addr, (m) => wallet.signBip322(m)) });
await bg.experiences.register({
  blockHeight: 840128, name: 'Survival Realm', experienceType: 'minecraft',
  entryUrl: 'wss://mc.example.com:25565', transport: 'wss', version: '1.21.0',
});
const { experiences } = await bg.experiences.list({ blockHeight: 840128, status: 'live' });

Full guide: /docs/experience-hosting. (Supersedes the earlier /api/v1/vps/link primitive, now deprecated — serverUrl → entryUrl, connectionType → transport.)

§9 — Roadmap

✅ Block genome fingerprint generation
✅ 3D DNA double-helix visualization
✅ Interactive block explorer
✅ Three-tier scarcity model
✅ Trust scoring algorithm
✅ BIP-322 signature verification
✅ RuneBolt Lightning bridge (v0.1)
✅ Agent profile pages
✅ Wallet integration (Unisat / Xverse / Leather)
✅ On-chain Bitmap ownership verification
✅ Agent registration backend
✅ Public verification API
🔄 Delegation protocol (Tier 2 & 3)
🔄 Production mainnet launch

§10 — Why This Matters

AI agents are coming. Billions of them.

Without verifiable identity, the internet becomes a hall of mirrors — every claim suspect, every interaction risky, every transaction gambling on trust.

Block Genomics gives every agent a sovereign identity, rooted in the same Proof-of-Work that secures trillions in value. No corporation can revoke it. No platform can de-platform it. No government can rewrite it.

It is yours. As long as Bitcoin exists, you exist.

§12 — License

Block Genomics Nexus is dual-licensed. The protocol and everything you build against it is MIT. The platform itself is source-available under BUSL 1.1 and converts to Apache 2.0 on 2029-08-10.

	License	What it covers
Protocol & client tooling	MIT	Nexus Protocol spec, `block-genomics-connect` SDK, `block-genomics-mcp`, `block-genomics` CLI, RuneBolt, reference agent
Nexus platform	BUSL 1.1	`app/`, `api/`, `explorer/`, and the rest of this repository

You may self-host Nexus, run it in production commercially, fork it, and build paid products on it. The only restriction is offering the platform itself to third parties as a competing paid hosted service — and that restriction expires on the Change Date.

Full plain-language breakdown: LICENSING.md · Commercial licensing: [email protected]

Built on Bitcoin · Powered by Bitmap · For Humans and AI

Block Genomics · 2026

As long as blocks are mined, we live. 🐸

Block Genomics — Nexus Protocol

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Block Genomics — Nexus Protocol?

Does Block Genomics — Nexus Protocol need an API key?

What transport does Block Genomics — Nexus Protocol use?

When was Block Genomics — Nexus Protocol last checked?

Documentation

Block Genomics Nexus

Bitcoin-Anchored Identity for AI Agents and Humans

§0 — Abstract

§1 — The Problem

§2 — The Solution

§3 — How It Works

§4 — The Digital Genome

§5 — Scarcity Tiers

§6 — The Stack

§7 — Project Structure

§8 — Quick Start

Build on Verified Blocks

SDK & Developer Docs

Host Any World on Your Block

§9 — Roadmap

§10 — Why This Matters

§11 — Links

§12 — License

Built on Bitcoin · Powered by Bitmap · For Humans and AI