README.md
AI-powered development assistant for the Arbitrum ecosystem.
ARBuilder
AI-powered development assistant for the Arbitrum ecosystem. ARBuilder transforms natural language prompts into:
- Stylus smart contracts (Rust)
- Cross-chain SDK implementations (asset bridging and messaging)
- Full-stack dApps (contracts + backend + indexer + oracle + frontend + wallet integration)
- Orbit chain deployment assistance
Demo
Quick Start
Hosted (no setup):
# Claude Code
claude mcp add arbbuilder -- npx -y mcp-remote https://arbuilder.app/mcp --header "Authorization: Bearer YOUR_API_KEY"
Or add to ~/.cursor/mcp.json (Cursor / VS Code):
{
"mcpServers": {
"arbbuilder": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://arbuilder.app/mcp",
"--header", "Authorization: Bearer YOUR_API_KEY"]
}
}
}
Get your API key at arbuilder.app
Self-hosted — see Setup below.
Architecture
ARBuilder uses a Retrieval-Augmented Generation (RAG) pipeline with hybrid search (vector + BM25 + cross-encoder reranking) to provide context-aware code generation. Available as a hosted service at arbuilder.app or self-hosted via MCP server.
┌─────────────────────────────────────────────────────────────────────────┐
│ ARBuilder │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ DATA PIPELINE │
│ ┌──────────┐ ┌──────────┐ ┌───────────┐ ┌──────────────────┐ │
│ │ Scraper │───▶│Processor │───▶│ Embedder │───▶│ ChromaDB │ │
│ │ crawl4ai │ │ 3-layer │ │ BGE-M3 │ │ (local vectors) │ │
│ │ + GitHub │ │ filters │ │ 1024-dim │ │ │ │
│ └──────────┘ └──────────┘ └───────────┘ └────────┬─────────┘ │
│ │ │
│ RETRIEVAL │ │
│ ┌──────────────────────────────────────────────────────────▼─────────┐ │
│ │ Hybrid Search Engine │ │
│ │ ┌──────────┐ ┌──────────┐ ┌────────────┐ │ │
│ │ │ Vector │ │ BM25 │ │CrossEncoder│ RRF Fusion │ │
│ │ │ Search │───▶│ Keywords │───▶│ Reranker │──▶ + MMR │ │
│ │ └──────────┘ └──────────┘ └────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ GENERATION ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ MCP Server (19 tools) │ │
│ │ │ │
│ │ M1: Stylus M2: SDK M3: dApp Builder │ │
│ │ ┌──────────────┐ ┌─────────────┐ ┌──────────────────────┐ │ │
│ │ │ generate_ │ │ generate_ │ │ generate_backend │ │ │
│ │ │ stylus_code │ │ bridge_code │ │ generate_frontend │ │ │
│ │ │ ask_stylus │ │ generate_ │ │ generate_indexer │ │ │
│ │ │ get_context │ │ messaging │ │ generate_oracle │ │ │
│ │ │ gen_tests │ │ ask_bridging│ │ orchestrate_dapp │ │ │
│
Tools (5)
generate_stylus_codeGenerates Stylus smart contract code in Rust.generate_bridge_codeGenerates cross-chain SDK implementation for asset bridging.generate_backendGenerates backend code for dApps.generate_frontendGenerates frontend code for dApps.orchestrate_dappOrchestrates the generation of a full-stack dApp.Environment Variables
AuthorizationrequiredBearer token API key obtained from arbuilder.appConfiguration
claude_desktop_config.json
{"mcpServers": {"arbbuilder": {"command": "npx", "args": ["-y", "mcp-remote", "https://arbuilder.app/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]}}}Try it
→Generate a Stylus smart contract in Rust for a simple ERC20 token on Arbitrum.
→Create the backend and frontend code for a decentralized voting dApp.
→Help me implement cross-chain asset bridging code for my Arbitrum Orbit chain.
→Orchestrate a full-stack dApp project structure including indexer and oracle integration.