Open Source Zero Keys Human First v0.4.1 PyPI Live
Arc Agent Builder Kit

Build Arc-ready MCP agents from prompt to verified runtime.

The complete toolkit for agentic commerce on Arc. Turn docs into reviewable agent plans, USDC payment flows, x402 boundaries, and local-first playgrounds — all with human approval at every step.

Examples18
Docs49
Prompt packs6
MCP Tools14
01 · Workflows

From intent to verified agent flow.

Four steps with explicit inputs, outputs, review checkpoints, and safety boundaries. Built for proof-of-work, not speculative spending.

197%

Discovery

Map the actor, payment surface, docs source, and human approval boundary before code.

  • Arc MCP context
  • Use-case thesis
  • Source citations
  • Non-goals
295%

Architect

Turn requirements into schemas, runtime constraints, and wallet-safe contracts.

  • Intent JSON
  • Runtime choice
  • Idempotency
  • Approval gates
390%

Compose

Use local demos and prompts to produce reviewable outputs without side effects.

  • Playground state
  • Prompt snapshot
  • Unsigned draft
  • Manifest preview
485%

Verify

Check safety contracts, status helpers, and public documentation before next PR.

  • No keys
  • No broadcast
  • Human approval
  • Publish log
02 · Playground

Draft build plans from practical prompts.

Static homepage links into local-only playgrounds. No LLM calls, no wallet requests, no private keys, no transaction broadcast from this page.

Prompt presets

USDC payment intent x402 paid API gateway Arc wallet policy monitor Webhook reconciliation Job escrow simulator Receipt verifier
Draft an Arc payment-intent agent for a single-merchant storefront. Include webhook reconciliation, idempotency keys, a retry policy, and a hard human-approval gate before any wallet action.
RuntimeNode 20 / Edge Worker
SurfaceAPI route / CLI / local demo
Generated plan preview

Scaffold: Arc payment-intent workflow

Node 20 API route Risk · Medium until reviewed Human signs manually
  1. Capture amount, asset, recipient, memo, expiry, and status as frozen intent fields.
  2. Load Arc facts from MCP docs and cite the pages used in the plan.
  3. Generate unsigned transaction preview only after validation passes.
  4. Block wallet handoff until chain, recipient, decimals, and approval copy are reviewed.
  5. Record local confirmation and publish what is verified, unknown, and deferred.
# Install from PyPI
pip install arc-builder-kit

# List available templates
arc-builder templates

# Scaffold a new project
arc-builder scaffold payment-intent-starter my-agent

# Run diagnostics
arc-builder doctor --include-circle-wallet

# Generate release packet
arc-builder release-packet --force
# Start MCP server (stdio)
arc-builder-mcp-server

# Example: tools/list request
{"jsonrpc":"2.0","id":1,"method":"tools/list"}

# Example: tools/call for scaffold
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"scaffold_project",
  "arguments":{"template":"payment-intent-starter","output_dir":"./my-agent"}
}}
# templates/payment-intent-starter/server.py
from http.server import HTTPServer, BaseHTTPRequestHandler
import json

class PaymentHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header("Content-Type", "application/json")
        self.end_headers()
        self.wfile.write(json.dumps({
            "status": "ready",
            "chain": "ARC-TESTNET",
            "token": "USDC"
        }).encode())

# Run: python3 server.py
# arc_builder_kit/circle_wallet_sdk.py
from arc_builder_kit import CircleWalletClient

# Read-only balance check
client = CircleWalletClient()
balance = client.get_balance(
    address="0x0cd9...ea401",
    chain="ARC-TESTNET"
)
print(balance["data"]["balances"])

# Gas estimate (no cost, no side effects)
estimate = client.estimate_transfer(
    to="0x...",
    amount="1.00",
    token="USDC"
)
02.5 · Builder Tooling

CLI, MCP server, and starter templates.

Python stdlib only. Zero external dependencies. Install from PyPI or run directly from the repo. Fail-closed design for CI/CD pipelines.

$ pip install arc-builder-kit Successfully installed arc-builder-kit-0.4.1

$ arc-builder templates payment-intent-starter Payment intent agent scaffold x402-agent-starter x402 paid API boundary job-escrow-starter ERC-8183 job escrow marketplace Agent marketplace server treasury Treasury dashboard UI x402-verified-api Verified x402 API

$ arc-builder scaffold payment-intent-starter my-agent ✓ Scaffolded to ./my-agent # Next: cd my-agent && python3 server.py
CLI

arc-builder CLI

Templates, scaffold, validate, facts, manifest, release-packet, doctor. All subcommands return non-zero on error for CI fail-closed behavior.

MCP

arc-builder-mcp-server

stdio JSON-RPC 2.0 server with 14 tools: list_templates, scaffold_project, validate_repo, arc_builder_doctor, get_arc_testnet_facts, x402_manifest, generate_release_packet, wallet_status, wallet_balance, wallet_prepare_send, and more.

6

Starter Templates

Static HTML+JS or dependency-free Python servers. Each includes README with safety notes and usage instructions. No wallet or signing required.

Circle Wallet SDK

Optional integration via Circle CLI subprocess. Read-only balance checks, transaction history, gas estimates. Real transfers disabled by default (REAL_TRANSFER=0).

14
MCP Tools
6
Starter Templates
0
External Dependencies
100%
Python Stdlib

PyPI Installation

pip install arc-builder-kit — wheel and sdist available. Entry points: arc-builder and arc-builder-mcp-server.

CI GitHub Actions

Python 3.10–3.12 matrix, ruff lint, script tests, package distribution checks, and PyPI trusted publishing via OIDC.

RPC Fallback Chain

Automatic failover across primary Arc Testnet RPC and user-specified endpoints via ARC_RPC_FALLBACKS env var. No single point of failure.

x402 HTTP 402 Boundaries

Challenge-only 402 flow with swappable verifier. Local demo verifier accepts deterministic proofs; RpcVerifier checks on-chain USDC Transfer events.

03 · Analytics

Real metrics, not vanity numbers.

The homepage reports actual surfaces shipped in the repo: docs, demos, prompts, validators, MCP tools, and safety runbooks.

Repository surfaces
80+

Docs, prompts, examples, templates, validation scripts, MCP tools, CI workflows, and community files.

Safety boundaries
6

No custody, no private keys, no app backend/custody calls, no mainnet, no broadcast by default, no secrets in repo.

By builder surface

Docs49
Examples18
Templates6
MCP Tools14
Prompts6
04 · Playbooks

Ship-ready recipes for Arc builders.

Each recipe opens a real doc or local playground — no dead buttons, no placeholders. From payment intents to x402 boundaries to Circle wallet integration.

USDC payment-intent agent

Prepare a payment request, freeze reviewed fields, preview unsigned calldata, and keep final approval manual.

CommerceNode 20Local-only Open playground →

CLI & MCP Server

Dependency-free arc-builder CLI with 8 subcommands and stdio MCP server with 14 tools. Scaffold projects, validate repos, run diagnostics.

InfrastructurePython stdlibPyPI Read tooling docs →

MCP Setup Guide

Connect AI coding tools to Arc docs through the MCP surface. Verify retrieved context and configure your editor.

InfrastructureMCPSetup Open setup guide →

x402 paid API boundary

Challenge-only 402 flow with a swappable verifier boundary for future paid API settlement work.

CommerceHTTP 402No payment created Open recipe →

Job escrow simulator

Walk through ERC-8183-style job posting, simulated funding, agent submission, and human-approved payout.

Agent jobsEscrowSimulator Open simulator →

Circle wallet payment demo

Live USDC balance, on-chain gas estimates, and tx history via Circle CLI. Optional real transfers with explicit confirmation.

Circle WalletLive USDCEstimate-first Open demo →

Arc Agent Treasury Lab

Connect local x402 revenue to bounded compute budgets, replay protection, verification loops, and an auditable treasury ledger.

Agentic loopsUSDC policyLocal-only Open treasury lab

Read-only transaction evidence

Check hash state and compare expected Arc Testnet USDC recipient/amount fields without wallet connection, signing, broadcast, or settlement claims.

InfrastructureRPCRead-only Check status →

Agent payment receipt viewer

Inspect Arc Testnet receipt status, gas used, raw logs, and pinned USDC Transfer events through read-only RPC only.

InfrastructureReceiptRead-only View receipt →

Payment intent receipt matcher

Compare a payment intent JSON with an Arc Testnet transaction receipt and check whether the onchain USDC Transfer matches recipient, token, and amount.

InfrastructureIntent matchRead-only Match intent →
Agent Commerce Live Real USDC transactions on Arc Testnet via Circle agent wallet — 6 verified on-chain payments. Circle Wallet Lab Circle agent wallet bootstrap on Arc Testnet: login, faucet, transfer, CCTP bridge.

Guarded Arc Testnet wallet send

Review a pinned USDC payload and keep the injected-wallet request disabled until every explicit human gate passes.

Arc TestnetInjected walletDisabled by default Inspect guarded lab

Receipt verifier

Review chain ID, recipient, amount, asset, intent hash, expiry, and transaction hash shape from local JSON.

VerificationJSONNo backend Verify receipt →

Builder content pack

Turn the build into Russian Telegram copy, X drafts, Discord updates, thumbnails, and a demo storyboard.

ContentPublic updateProof-of-work Open pack →
05 · Documentation

Docs, changelog, and safety pages — all real links.

Every public entry routes to the styled docs viewer, local playground, repository, or community file. No placeholder # links.

Builder tooling

Unified CLI, stdio MCP server, starter templates, and safe project scaffolding.

Read tooling →

MCP setup

Connect AI coding tools to Arc docs through the MCP surface and verify retrieved context.

Read setup →

Arc docs map

Network config, contracts, agent primitives, tutorials, tools, and recommended build path.

Open map →

Prompt library

Copy-ready prompts for docs-aware coding, payment intents, agent identity, escrow, and reviews.

Use prompts →

Payment intent demo

Live Circle wallet integration: balance checks, gas estimates, transaction history. Optional real transfers with explicit confirmation.

Read demo docs →

Circle wallet lab

Bootstrap Circle agent wallet on Arc Testnet: login, faucet, transfer, CCTP bridge.

Read lab docs →

Agent commerce live

Real on-chain USDC transactions via Circle agent wallet — 6 verified payments with evidence.

Read evidence →

Current readiness report

Scope verdict, local evidence commands, future-extension boundaries, and safe public wording.

Read report →

Safe-scope completion contract

Measurable acceptance criteria, canonical verification, explicit non-goals, and reviewer wording.

Review contract →

Send readiness gate

Evidence contract for the separate disabled-by-default Arc Testnet browser-wallet send lab.

Review gate →

Guarded wallet send runbook

Operator sequence, stop conditions, rollback, and verification boundary for the isolated Arc Testnet send lab.

Open guarded runbook

Custody and mainnet gates

Why custody needs a separate backend and why Arc mainnet stays blocked until official configuration and review exist.

Review gates

Arc Testnet operator runbook

Manual review steps, stop conditions, and evidence records for the guarded send lab.

Open runbook →

Operator evidence packet

Strict Arc Testnet review record with fail-closed validation and disabled live-send controls.

Review schema →

Receipt viewer

Read-only Arc Testnet receipt lookup with USDC Transfer log highlighting and no wallet path.

Review receipt flow →

Payment intent receipt matcher

Compare a payment intent with an Arc Testnet receipt's USDC Transfer logs and emit a match/mismatch evidence verdict.

Review matcher flow →

Agentic maintainer loop

Operate coding agents through scoped edits, deterministic checks, event triggers, and human approval gates.

Review loop →

Public launch packet

Human-review Telegram, X, Discord/Arc House drafts, submission checklist, links, and claims to avoid.

Prepare launch →

Readiness checklist

Pre-submit gates for docs grounding, payment safety, UX states, repo quality, and public proof.

Check gates →

Changelog / build log

What shipped, what was verified, current safety boundaries, and optional future extensions.

Read changelog →

Security

Secret handling, report path, non-custodial defaults, and safe demo boundaries.

Security page →
06 · Status

Production-ready kit, extensions clearly separated.

The static builder kit is complete for sharing. Local-only surfaces stay wallet-free. The isolated Arc Testnet send lab remains disabled until every explicit review gate passes.

Complete

Landing page, docs viewer, 49 docs, 18 examples, 6 prompt packs, PyPI package, Circle Wallet SDK, RPC fallback chain, x402 verifier, CLI with 8 subcommands, MCP server with 14 tools, and 6 starter templates — shipped and green.

Measured

The safe-scope completion contract and dependency-free completion check keep the readiness claim reproducible. CI runs Python 3.10–3.12 matrix with ruff lint and script tests.

Safe default

Local-only demos remain wallet-free. The payment intent demo connects to Circle CLI for real balance/estimate data but stays estimate-only by default (REAL_TRANSFER=0).

RPC resilient

Automatic fallback chain: primary Arc Testnet RPC → user-specified endpoints via ARC_RPC_FALLBACKS env var. No single point of failure.

Guarded write

One capped 1.00 USDC Arc Testnet transfer is possible only after explicit enablement, typed confirmation, and final human click.

Developer UX

PyPI installable with entry points: arc-builder CLI and arc-builder-mcp-server. Zero external dependencies — Python stdlib only.

07 · Roadmap

What's shipped, what's next, what's deliberately out of scope.

Honest build log. No vaporware promises. Every item links to real code, real docs, or an explicit non-goal.

Shipped

v0.4.1 — Builder Tooling

  • PyPI package arc-builder-kit with CLI + MCP server
  • 6 dependency-free starter templates
  • Circle Wallet SDK (read-only + guarded write)
  • RPC fallback chain + x402 verifier
  • 49 docs, 18 examples, 6 prompt packs
Full changelog →
Future

v0.6.0+ — Production Hardening

  • Mainnet evaluation (separate security review)
  • Account abstraction / custody provider review
  • Live Circle Contracts integration
  • Community plugin registry
Extension boundaries →
Out of Scope

Deliberately Not Building

  • Custodial wallets or key management
  • Token issuance or DeFi yield products
  • Real-money payment processing
  • Centralized agent marketplace
Completion contract →
08 · FAQ

Questions builders actually ask.

Short answers. No marketing fluff. If the answer is "it depends," we say why and link to the docs.

Is this an official Arc Network product?

No. Independent builder kit maintained by Anstrays. Not endorsed by Arc, Circle, or any foundation. Built for the Arc Testnet builder community.

Do I need to install anything to try the demos?

No. All playgrounds are static HTML+JS, wallet-free, and run locally in your browser. For CLI/MCP tooling: pip install arc-builder-kit.

Can I use this on Arc Mainnet?

Not yet. Current scope is Arc Testnet only. Mainnet evaluation requires a separate security review, custody assessment, and explicit human approval. See extension boundaries.

Does the payment demo move real USDC?

By default, no. Balance checks and gas estimates are read-only. A guarded send path exists but requires REAL_TRANSFER=1, typed confirmation, and a final human click. Max 1.00 USDC on Testnet.

What's the MCP server for?

The arc-builder-mcp-server exposes 14 tools (scaffold, validate, doctor, facts, manifest, wallet status, etc.) over stdio JSON-RPC 2.0. Connect it to Claude Code, Cursor, or any MCP-compatible IDE for docs-aware coding.

Are there any external dependencies?

Zero. Python stdlib only. The PyPI package is self-contained. Templates are static HTML or dependency-free Python servers. No requirements.txt to audit.

How do I contribute?

Open an issue or PR on GitHub. The repo has pre-commit guards, CI (Python 3.10–3.12), and a completion contract. Read CONTRIBUTING first.

What about x402 payments?

x402 is an HTTP 402 payment-required flow. The kit includes a challenge-only boundary with swappable verifier (local demo + RpcVerifier for on-chain USDC Transfer events). No payment is created automatically.

09 · Changelog

Version history, condensed.

Every version ships with a completion contract check. No "minor fixes" without substance.

v0.4.1
July 2026

Builder Tooling & Site Redesign

  • Full dark-theme redesign with CSS-only interactive tabs
  • Mobile adaptation (375px+, hamburger menu)
  • New sections: Roadmap, FAQ, Changelog
  • PyPI package arc-builder-kit live
  • Circle Wallet SDK integration (read-only + guarded write)
  • RPC fallback chain + x402 verifier boundary
  • 45+ tests, validation, CI green
v0.4.0
June 2026

CLI, MCP Server & Templates

  • arc-builder CLI with 8 subcommands
  • arc-builder-mcp-server with 14 tools
  • 6 starter templates (payment, x402, escrow, marketplace, treasury, verified API)
  • PyPI trusted publishing via OIDC
  • Pre-commit guards + completion contract
v0.3.0
May 2026

Payment Intent & Circle Wallet

  • Payment intent playground with Circle CLI integration
  • Real balance checks, gas estimates, transaction history
  • Guarded send path (1.00 USDC cap, typed confirmation)
  • Agent commerce live evidence (6 verified payments)
v0.2.0
April 2026

Agent Commerce & x402

  • Agent commerce starter-kit (components, flows, identity, review packet)
  • x402 local challenge server + manifest
  • Job escrow simulator (full lifecycle)
  • Arc Agent Treasury Lab
v0.1.0
March 2026

Initial Release

  • Landing page + docs viewer
  • Payment intent playground (local-only)
  • Receipt verifier, viewer, matcher
  • Arc docs map + prompt library