Skip to main content

Introduction to BMCPS v3.0

Frozen reference

BMCPS v3.0 was written in 2025 and frozen in October 2026. Read Status, known limits, and what I'd change today first.

Welcome to BMCPS v3.0 (Blockchain Multi-Protocol Standard): a standard for blockchain AI integration, written to address the context rot problem.

What is BMCPS?​

BMCPS is a comprehensive standard for building AI-to-blockchain integrations. Unlike traditional approaches that lock you into a single protocol, BMCPS generates 4 different formats from one universal schema:

  • MCP Servers - Full-featured Claude Desktop integration (~5k token context)
  • OpenAI Functions - Lightweight function calling (~500 token context)
  • REST APIs - Zero context overhead for production scale
  • JSON Schemas - Format-agnostic base for custom protocols

The Context Rot Problem​

At AI Engineer Summit 2025, a critical limitation of MCP was identified: context rot. When MCP loads all tool definitions into context upfront (~5k tokens), it:

  • Wastes valuable context space in long conversations
  • Limits the room for actual conversation history
  • Becomes problematic for extended agent sessions

BMCPS solves this by offering protocol flexibility. Choose the format that matches your context requirements:

ProtocolContext CostBest Use Case
REST API0 tokensProduction apps, high-scale systems
OpenAI Functions~500 tokensLong conversations, extended sessions
MCP Server~5k tokensFeature-rich, short interactions

Quick Example​

Generate an Ethereum integration in any format:

# OpenAI Functions (low context)
node bmcps-generator.js --blockchain eth --format openai

# MCP Server (full features)
node bmcps-generator.js --blockchain eth --format mcp

# REST API (zero context)
node bmcps-generator.js --blockchain eth --format rest-api

# All formats at once
node bmcps-generator.js --blockchain eth --format all

Each command generates a project skeleton with:

  • All 25 mandatory BMCPS tools, as stub handlers
  • Documentation
  • A test scaffold
  • TypeScript types where applicable (the MCP output needs a fix to compile; see Status)

Why BMCPS?​

1. Protocol Flexibility​

Don't get locked into one protocol. Generate MCP for prototyping, then switch to REST API for production — same tools, different transport.

2. Context Management​

Choose your context overhead:

  • 0 tokens (REST API) for unlimited scale
  • ~500 tokens (OpenAI) for long conversations
  • ~5k tokens (MCP) for feature-rich interactions

3. Chain-Agnostic Design​

One 25-tool interface meant to fit Ethereum, Bitcoin, Solana, Avalanche, Polygon, and more. The generator knows 17 chain identifiers; those are targets, not working integrations.

4. Code Generation​

Generate a starting skeleton for any of the four formats from one schema. Handlers are stubs you implement.

5. Tested, With Known Gaps​

  • 238 automated generator tests (all passing), which check the shape of generated files rather than that they build
  • Error handling patterns
  • Security guidance
  • Testing standards

What's Included?​

Core Tools (25 mandatory)​

Every BMCPS integration includes:

  • Core Operations (5): get_chain_info, get_balance, get_transaction, get_block, validate_address
  • Transactions (2): get_transaction_history, send_transaction
  • Wallet Management (3): create_wallet, import_wallet, generate_address
  • Network Control (3): get_network_info, set_network, get_gas_price
  • Fee Management (2): estimate_fees, get_mempool_info
  • Account Info (2): get_wallet_info, get_account_info
  • Token Operations (5): get_token_balance, get_token_info, transfer_token, approve_token, get_token_allowance
  • Help System (3): help, search_tools, list_tools_by_category

Generator Features​

  • Multi-format output - MCP, OpenAI, REST API, JSON Schema
  • 17 chain identifiers - EVM, SVM, Move-based, and more (generator targets)
  • Complete documentation - README, examples, usage guides
  • Type safety - Full TypeScript support for MCP
  • Testing included - Jest test suites generated automatically

Getting Started​

Ready to build? Choose your path:

  1. Quick Start - Generate your first integration in 5 minutes

  2. Choose a Protocol - Understand which format fits your needs

  3. Read the Standard - Deep dive into BMCPS v3.0 specification

  4. See All Tools - Browse the universal tool registry

Architecture Overview​

┌─────────────────────────────────────┐
│ tools-schema.json │ ← Universal source of truth
│ (25 tool definitions) │
└───────────┬─────────────────────────┘
│
┌───────┴────────────────┬─────────────┬────────────┐
↓ ↓ ↓ ↓
┌──────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐
│ OpenAI │ │ MCP │ │REST API │ │ JSON │
│Functions │ │ Server │ │ │ │ Schema │
└──────────┘ └──────────┘ └─────────┘ └──────────┘
~500 tokens ~5k tokens 0 tokens N/A

One schema → Multiple protocols → Choose what fits

Key Concepts​

Protocol-Agnostic Design​

BMCPS tool definitions are independent of transport protocol. The same get_balance tool works whether you're using MCP, OpenAI Functions, or REST API.

Modular Architecture​

Tools are organized by category:

  • core/ - Blockchain fundamentals
  • wallet/ - Wallet operations
  • network/ - Network management
  • tokens/ - Token operations
  • help/ - Help system
  • And more...

Compliance Levels​

  • Bronze (Minimum Viable): 25 core tools
  • Silver (Production Ready): 40+ tools, full architecture compliance
  • Gold (Enterprise Grade): 100+ tools, optimized, audited

Community & Support​

Version Information​

  • Current Version: v3.0.0
  • Written: 2025
  • Status: Frozen as a reference (October 2026). See Status
  • Tests: 238/238 generator tests passing (structural checks)

Ready to start building? Head to the Quick Start Guide and generate your first integration!