Building with AI

Makechain provides multiple ways for AI assistants to access protocol documentation, search source code, and query live chain data. The MCP server is the most powerful option — it gives assistants direct access to the full codebase and protocol API.

MCP server

The Makechain MCP server at mcp.makechain.net exposes 16 tools for searching the codebase, searching MIPs, reading documentation, and querying the live protocol API. It follows the Model Context Protocol standard and works with any MCP-compatible client.

Under MIP-3, accounts are identified by owner_address (20-byte EVM address). Protocol tools use that identifier on the address-native variant.

Tools

Tool	Description
`get_file`	Retrieve a source file by path at any git ref (branch, tag, or SHA)
`search_code`	Search the codebase via GitHub code search; supports directory and extension filters
`list_files`	Browse the directory tree at a given path and ref
`get_overview`	Repository overview — README and CLAUDE.md
`get_spec`	Protocol specification — full or by section
`get_docs`	Documentation pages from the docs site
`search_mips`	Search Makechain Improvement Proposals by number or keyword
`semantic_search_mips`	Concept search over MIPs using hybrid retrieval
`get_project`	Project details by ID or by owner address and name
`list_projects`	List projects, optionally filtered by owner address
`get_account`	Account details by owner address or public key
`get_ref`	Get a specific ref from a project
`list_refs`	List all refs for a project
`get_commit`	Commit details from a project
`get_chain_stats`	Chain statistics — block height, message counts
`get_block`	Block details by block number

Codebase tools (get_file, search_code, list_files, get_overview, get_spec, get_docs) call GitHub directly with a 5-minute edge cache — there is no internal index to fall behind. Pass ref to read at a tag or commit SHA; defaults to main. MIP tools use Cloudflare AI Search against mips.makechain.net. Protocol tools proxy through the REST gateway at api.makechain.net.

Claude Code

Add the MCP server to Claude Code:

claude mcp add --transport sse makechain https://mcp.makechain.net/sse

Claude Code can now search the Makechain codebase, read the protocol spec, and query live chain data directly.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "makechain": {
      "url": "https://mcp.makechain.net/sse"
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "makechain": {
      "url": "https://mcp.makechain.net/sse"
    }
  }
}

Any MCP client

Connect to the SSE endpoint at https://mcp.makechain.net/sse. The server returns a session endpoint on connection. Send JSON-RPC messages to the session endpoint to call tools.

llms.txt

The docs automatically generate llms.txt files for LLM consumption:

/llms.txt — a concise index of all pages with titles and descriptions
/llms-full.txt — complete documentation content in a single file

Use llms-full.txt to give an AI assistant full context on the Makechain protocol in one shot.

Ask AI

Every documentation page includes an "Ask in ChatGPT" button that opens the current page context in ChatGPT with a Makechain-aware prompt. The dropdown also lets you copy the raw page content for pasting into any AI assistant.

Use ⌘ + I (macOS) or Ctrl + I (Windows/Linux) to quickly access the AI menu.

Using with Claude

Copy the page content (or the full llms-full.txt URL) and paste it into Claude:

Read the Makechain protocol documentation at https://docs.makechain.net/llms-full.txt
and answer my questions about it.

Using with ChatGPT

Click the "Ask in ChatGPT" button on any page, or open ChatGPT and provide the docs URL:

Research this page: https://docs.makechain.net/protocol/overview
and help me understand the message semantics.

Markdown access

Any documentation page can be accessed as raw Markdown by appending .md to the URL:

https://docs.makechain.net/protocol/messages.md

This provides better token efficiency and easier parsing for LLMs compared to HTML.

Example prompts

Here are effective prompts for working with Makechain using AI assistants:

Protocol understanding

What are the differences between 1P and 2P message semantics in Makechain?
How does the compare-and-swap mechanism work for REF_UPDATE?

Building on Makechain

Show me how to construct and sign a PROJECT_CREATE message using Ed25519.
How do I verify an Ethereum address claim signature?

Architecture questions

How does the two-phase execution model work? Why are some messages
processed serially in the account pre-pass?

Debugging

I'm getting a StorageLimitExceeded error when creating a project.
What are the storage limits and how do I check my capacity?

Protocol specification

The complete protocol specification is available in the repository at protocol/SPECIFICATION.md. This is the canonical reference — the documentation site is derived from it.

For AI assistants working with the codebase, the CLAUDE.md file provides build commands, architecture overview, module descriptions, and conventions.

Edit this page on GitHub