Blue Agent

June 17, 2026 · View on GitHub

AI-native founder console + tool marketplace for Base builders.

Blue Agent is a full economic actor on Base: it holds a wallet, executes onchain transactions, powers a growing ecosystem of tools, and helps builders go from idea to shipped product.

Blue Hub — 74 AI Tools on Base

Blue Hub is a curated marketplace of 74 pay-per-call AI tools built on Base. Any agent or developer can call tools via x402 micropayments in USDC — no API key, no account, no human in the loop.

# Discover all tools + prices
GET https://blueagent.dev/api/catalog

# Machine-readable x402 pricing
GET https://blueagent.dev/.well-known/pricing

# Call any tool
POST https://blueagent.dev/api/x402/{tool-id}
X-Payment: <EIP-3009 USDC on Base>

74 tools across 9 categories — intelligence · builder · trading · security · agent-economy · base-ecosystem · on-chain · content · earn

Registry: ERC-8257 ToolRegistry · agentic.market · CDP Bazaar

x402 SDK

npm install @blueagent/x402

import { createX402Client } from "@blueagent/x402"

const client = createX402Client({ privateKey: "0x..." })

// 5 core commands
const brief = await client.idea("gasless USDC tipping app on Base")
const arch  = await client.build("...")
const audit = await client.audit("0x<contract>")
const ship  = await client.ship("...")
const raise = await client.raise("...")

// Any Hub tool
const pick  = await client.tokenPick()
const news  = await client.hub("ecosystem-digest", { focus: "DeFi" })

// Discover pricing
const manifest = await client.pricing()
const price    = await client.priceOf("blue-audit") // { priceUSD: "\$1.00" }

The SDK handles the full x402 flow: 402 → decode requirements → sign EIP-3009 → retry → 200 OK

5 Core Commands

Command	What it does	Price
`blue idea`	Rough concept → fundable brief	$0.05
`blue build`	Brief → architecture + stack + file tree	$0.50
`blue audit`	Code → security review + go/no-go	$1.00
`blue ship`	Project → deploy checklist + release notes	$0.10
`blue raise`	Idea → pitch narrative + investor framing	$0.20

Install CLI

npm install -g @blueagent/cli

export BANKR_API_KEY=your_key_here
blueagent

Navigate with ↑ ↓ Enter. Press Esc to go back.

Categories in the TUI

Category	Tools
Build	idea · build · audit · ship · raise
Intelligence	base-alpha · token-alpha · protocol-health · founder-check · narrative-pulse · token-pick-signal · ecosystem-digest · market-fit · blue-research
On-chain	token-price · pool-scan · wallet-holdings · new-pools · gas-tracker · scam-detector · cross-protocol-yield · whale-tracker · dex-flow · aml-screen · airdrop-check
Security	quick-safety · wallet-risk · honeypot-check · risk-gate · deep-analysis · contract-trust · key-exposure · token-distribution · liquidity-depth
Builder	roadmap-validator · competitor-scan · pitch-intelligence · gtm-brief · stack-recommender · investor-memo · repo-health · builder-deep-dd · grant-evaluator
Trading	whale-copy-signal · token-momentum-scanner
Content	thread-intelligence · community-growth-playbook
Earn	lp-analyzer · cross-protocol-yield
Tasks	post-task · accept · submit · list
Bankr	swap · transfer · portfolio · launch-token

System check

blue doctor

Blue Terminal

Browser-based CLI at blueagent.dev/terminal — run all 74 Hub tools, 5 core commands, and onchain queries directly in the browser. No install required.

blue hub ls                    # list all 74 tools
blue hub info token-pick-signal
blue idea <prompt>             # \$0.05 via Bankr LLM
blue balance 0x...             # ETH + USDC on Base mainnet

Blue Tasks

Tasks are local micropayment jobs — post work, accept it, submit proof. Data lives at ~/.blue-agent/tasks.json.

# In TUI: Tasks → blue post-task
title:       "Audit smart contract for reentrancy"
reward:      5          # USDC
category:    audit

# Doer accepts
Tasks → blue accept → taskId + handle

# Doer submits proof
Tasks → blue submit → taskId + proof URL

Fee = 5% platform cut. Doer receives 95%.

Builder Score / Agent Score

# In TUI: Score → builder-score
handle: madebyshun

Builder Score dimensions (max 100): activity · social · uniqueness · thesis · community

Repo structure

blue-agent/
├── apps/
│   └── web/              # Next.js 15 — /hub, /console, /terminal, /skills
├── packages/
│   ├── x402-client/      # @blueagent/x402 — x402 SDK for Blue Hub
│   ├── cli/              # @blueagent/cli — TUI (Ink + React)
│   ├── core/             # Shared schemas, pricing, tool-input specs
│   ├── bankr/            # Bankr LLM client (callBankrLLM)
│   ├── payments/         # x402 payment helpers
│   ├── reputation/       # @blueagent/reputation — Builder Score + Agent Score
│   ├── skill/            # @blueagent/skill — MCP server
│   └── skills/           # Bundled .md skill files
├── bankr-skills/         # BankrBot/skills submissions (blue-hub + 5 commands)
├── commands/             # Command contract docs (idea.md, build.md, ...)
├── scripts/              # register-all-tools.sh — ERC-8257 registration
└── docs/                 # Product brief, roadmap, quickstart

Published packages

Package	Version	Description
`@blueagent/x402`	0.1.0	x402 SDK — call any Blue Hub tool
`@blueagent/cli`	1.3.14	CLI/TUI — full builder console
`@blueagent/skill`	0.1.1	MCP server for Blue Agent tools
`@blueagent/reputation`	0.1.1	Builder Score + Agent Score

Tech stack

Layer	Tech
Frontend	Next.js 15, App Router, Tailwind
CLI/TUI	Ink (React for terminals)
LLM	Bankr LLM — `https://llm.bankr.bot/v1/messages`
Payments	x402 v2 + USDC on Base
Chain	Base only (chain ID 8453)
Registry	ERC-8257 ToolRegistry on Base

Tokens

$BLUEAGENT — 0xf895783b2931c919955e18b5e3343e7c7c456ba3 (Base, Uniswap v4)

Hard rules

Base chain only. All addresses and transactions target Base (chain ID 8453).
All AI calls go through Bankr LLM. packages/bankr → callBankrLLM(). No direct OpenAI or Anthropic calls.
Never invent contract addresses. If an address is needed and not in the codebase, flag it.
Business logic in packages, not in apps. Keep apps/web thin.

Commit convention

feat:     new feature
fix:      bug fix
skill:    new skill or grounding file
cmd:      command contract change (commands/*.md)
docs:     documentation only
refactor: restructure, no behavior change
chore:    tooling, deps, config

Branch: always work on dev. PRs go dev → main.