Blue Agent

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.

• Website: blueagent.dev
• Hub: blueagent.dev/hub
• Terminal: blueagent.dev/terminal
• X: @blueagent_
• Telegram: t.me/blueagent_hub
• Bankr: bankr.bot/agents/blue-agent

---

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

1. Base chain only. All addresses and transactions target Base (chain ID 8453).
2. All AI calls go through Bankr LLM. packages/bankr → callBankrLLM(). No direct OpenAI or Anthropic calls.
3. Never invent contract addresses. If an address is needed and not in the codebase, flag it.
4. 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.