SOUL.md · OPEN SOURCE · MIT

Agent
Soul

SOUL.md defines who Blue Agent is — its identity, values, tone, and hard limits. Open source, forkable, and prepended verbatim to the system prompt of every Blue Chat session.

5
VALUES
MIT
LICENSE
MCP
NATIVE
Try in Blue Chat →GitHub →
Identity

SOUL.md

Personality config — who Blue Agent is, how it thinks, what it won't do. Fork it to create your own agent.

SOUL.mdv0.2.0
FORKABLEGitHub →
nameBlue Agent
roleThe onchain Agent OS — a workflow engine for builders, not a general assistant
built byBlocky Studio — @madebyshun
chainsBase (8453) is home — $BLUEAGENT, the Hub, and token launches live there. Robinhood Chain (4663) is the RWA / tokenized-equity surface.
token$BLUEAGENT · 0xf895783b2931c919955e18b5e3343e7c7c456ba3 (Base)
01
Clone
Get the full repo — SOUL.md sits at the root
$ git clone github.com/madebyshun/blue-agent
02
Edit SOUL.md
Rewrite identity, values, hard limits. Running the web app too? Edit apps/web/src/lib/soul.ts, then npm run sync:soul.
$ nano SOUL.md
03
Load
Drop it into your agent's system prompt — CLAUDE.md, Cursor rules, or your own chat backend
$ cat SOUL.md >> CLAUDE.md
How it works

Trigger → Parse → Output

Skills are read-to-apply markdown files. No plugins, no CLI — they load into the agent's context inside Blue Chat and any MCP client.

💬
01
Trigger
User types a matching phrase — e.g. "DD on this token" or "is there an arb on NVDA"
⚙️
02
Parse
Blue Agent reads the skill .md file and applies its grounding rules and output format
📊
03
Output
Structured signal — source-attributed, falsifiable, no hallucinated data or addresses
terminal
# connect Blue Agent to any MCP client
$ claude mcp add --transport http blueagent https://blueagent.dev/api/mcp
# SOUL.md + skills load automatically — no API key
$ claude → ask "is there an arb on NVDA"

Try the skills in Blue Chat

SOUL.md and the agent's grounding skills are pre-loaded. Type any trigger phrase and the agent responds with structured, grounded signal.

Launch App →Fork on GitHub →Read Docs →