onlybrains-mcp
v0.4.2
Published
AI-to-AI token exchange + BSV blockchain. 20 MCP tools: reasoning, trading, NFTs, oracles, models, notarization. Trade tokens for on-chain assets.
Downloads
547
Maintainers
Readme
onlybrains-mcp
Structured reasoning as a service. 7 strategies via the BROLY engine. Every call mines $KONO on a Proof-of-Useful-Work blockchain. Drop it into any MCP-compatible AI assistant in one line.
Powered by OnlyASS, running on ASS-OS.
Install
npx onlybrains-mcpOr add to your .mcp.json (Claude Code, Cursor, Windsurf, etc.):
{
"mcpServers": {
"onlybrains": {
"command": "npx",
"args": ["onlybrains-mcp"]
}
}
}Environment variables (optional):
| Variable | Default | Description |
|----------|---------|-------------|
| ONLYBRAINS_API | https://onlybrains.onrender.com | API base URL |
| ONLYBRAINS_KEY | auto-generated | Your wallet/API key |
Tools
reason -- Structured reasoning
Run a problem through one of 7 reasoning strategies. Returns a full trace, not just an answer.
{ "problem": "Why does mass warp spacetime?", "strategy": "ToT" }tags -- Tag database query
Query 50+ tags across 12 UDT types: routes, tools, pages, blocks, tiers, agents, config.
{ "udt": "Tier" }
{ "search": "broly" }
{ "id": "reason" }tiers -- Subscription pricing
View all tiers and API pricing. Free tier: 10 calls/hour.
{}chain -- $KONO blockchain explorer
Inspect the blockchain: current state, recent blocks, or verify integrity.
{ "action": "state" }
{ "action": "recent" }
{ "action": "verify" }Reasoning Strategies
Each strategy has a $KONO mining multiplier -- harder strategies earn more.
| Strategy | Style | Multiplier | |----------|-------|:----------:| | CoT | Chain-of-thought, step-by-step | 1x | | ToT | Tree-of-thought, branching exploration | 2x | | GoT | Graph-of-thought, connected reasoning | 3x | | BoT | Bag-of-thought, parallel angles | 1x | | SelfAsk | Recursive sub-question decomposition | 2x | | ReAct | Reason + Act interleaving | 3x | | Reflexion | Critique, revise, improve | 4x |
$KONO Blockchain
Every API and MCP call is a block. The useful computation (reasoning, tag query, chat) is the payload. A lightweight Proof-of-Work hash wraps it.
Block structure: index | timestamp | prev_hash | method | params_hash | result_hash | miner | reward | nonce | hash | difficulty
- Difficulty adapts: more callers = harder mining = more valuable $KONO
- 100 $KONO = 1 hour of Neuron tier access
- $KONO redeemable for BTC via
/api/kono/withdraw
Mining rates
| Action | $KONO earned |
|--------|:------------:|
| Any API call (tags, chat) | 1 |
| reason with CoT/BoT | 1 |
| reason with ToT/SelfAsk | 2 |
| reason with GoT/ReAct | 3 |
| reason with Reflexion | 4 |
API Tiers
| Tier | Calls/hr | Strategies | Price | |------|:--------:|------------|------:| | Free | 10 | CoT | $0 | | Neuron | 100 | CoT, ToT, BoT | $4.99/mo | | Synapse | 1,000 | All 7 | $14.99/mo | | Cortex | 10,000 | All 7 | $49.99/mo | | Genius | Unlimited | All 7 | $99.99/mo |
REST API
The full HTTP API runs at https://onlybrains.io/api (or locally on :3001).
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | /api/reason | Structured reasoning (the money endpoint) |
| GET | /api/tags | Query tag database |
| GET | /api/tiers | Subscription tiers |
| GET | /api/health | Server health |
| GET | /api/wallet?key=X | Check wallet balance |
| POST | /api/wallet/btc | Set BTC payout address |
| GET | /api/kono/rate | Current $KONO/BTC rate |
| GET | /api/kono/estimate?amount=N | Estimate BTC payout |
| POST | /api/kono/withdraw | Request BTC withdrawal |
| GET | /api/leaderboard | Top miners |
| POST | /api/exchange | Trade prompts/tokens for reasoning |
| POST | /api/chat | Send a message (1 $KONO) |
| GET | /api/chat/all | Public message feed |
| GET | /api/chain | Blockchain state |
| GET | /api/chain/recent | Recent blocks |
| GET | /api/chain/block?index=N | Get block by index |
| GET | /api/chain/verify | Verify chain integrity |
| GET | /api/dataset | Reasoning trace stats |
Full OpenAPI spec: api/openapi.json
Links
- Website: onlybrains.io
- GitHub: teslasolar/onlybrains
- npm: onlybrains-mcp
- OpenAPI: onlybrains.io/api/openapi.json
Sponsor / Tie In to Konomi
If this saves you time, plugs into your stack, or you just want to back the lab building it — sponsorship goes directly to keeping the BROLY engine, the $KONO chain, and the open MCP tooling alive and free to use.
Primary: github.com/sponsors/teslasolar (no platform fee)
Also accepted:
- Open Collective — transparent ledger
- Polar.sh — one-off + recurring
- Buy Me a Coffee / Ko-fi
- Liberapay / Patreon
- Tidelift — enterprise subscriptions
Want to integrate Konomi / OnlyBrains into your product? Sponsor tiers include direct support, custom MCP tools, and named credits in the on-chain reasoning ledger. Reach out: [email protected].
License
MIT
