How do I install Cluster?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Cluster need an API key?

The publisher lists these environment variables: CLUSTER_API_URL, CLUSTER_API_KEY, CLUSTER_WALLET.

When was Cluster last checked?

Last checked 2026-11-08. Self-hostable index of AI financial agents — tokenized stocks + crypto, memory, LLM gateway.

Cluster MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.clusteragent.dev/mcp

Credentials from the publisher

CLUSTER_API_URL — Cluster backend base URL (default: https://clusteragent.dev)
CLUSTER_API_KEY — Cluster API key (clst_...) minted via wallet signature — required only for wallet-scoped tools
CLUSTER_WALLET — Default wallet address for wallet-scoped tools

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http dev.clusteragent-cluster-mcp https://mcp.clusteragent.dev/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "dev.clusteragent-cluster-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.clusteragent.dev/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

cluster

The runtime layer for agentic finance on Robinhood Chain. Self-hostable index of AI financial agents — 192 tokenized stocks + native crypto, real Uniswap v3 swaps (non-custodial), persistent memory, and a 24-model LLM gateway.

npx @clusteragent/cluster-mcp

npx skills add clusteragent/cluster        # any skills-CLI agent
pip install cluster-agent                  # Python SDK

Repo Layout

├── SKILL.md                    main installer skill (any agent)
├── index.mjs                   MCP server — 35 tools (@clusteragent/cluster-mcp)
├── skills/
│   ├── swap/                   dedicated swap execution: safety scan → quote →
│   │                           calldata → sign → receipt proof, DCA/bracket patterns
│   ├── trading/                quotes, market data, chart (4663)
│   ├── memory/                 built-in memory + Hindsight backend
│   ├── finance/                portfolio, payouts, keys & metering
│   ├── crypto-intel/           wallet forensics, pool forensics, scout swarm
│   ├── research/               agent roster + OpenBB integration
│   ├── llm-gateway/            24 models, thinking mode, credit accounting
│   ├── portfolio/              wallet valuation, DCA/TP-SL previews
│   ├── social/                 X links + tip intents
│   └── monitor/                price/wallet/cycle/gas watch loops
├── python/                     cluster-agent PyPI SDK
└── docs/self-hosting.md        deployment guide

11 skills total — 1 installer + 10 domain sub-skills.

The cluster backend, frontend and keeper bot are not in this repo — the bot signs real treasury transactions, so the operational stack stays private. This repo is the skill/MCP platform: point it at any cluster deployment.

Quick Start

Agent users — see SKILL.md. MCP config:

{ "mcpServers": { "cluster": {
    "command": "npx", "args": ["-y", "@clusteragent/cluster-mcp"],
    "env": { "CLUSTER_API_URL": "https://clusteragent.dev", "CLUSTER_API_KEY": "clst_...", "CLUSTER_WALLET": "0x..." }
}}}

Self-hosters — see docs/self-hosting.md. Docker images + a deployment guide; SQLite default, zero external services except one LLM key for chat.

Python — see python/:

from cluster import Cluster
c = Cluster(api_url="https://your-host", api_key="clst_...")
c.quotes(["NVDA", "PONS"]); c.payout_basket(); c.chat("hi", thinking=True)

The Mechanism

fees in ──▶ vault ──▶ keeper bot buys the 19-name basket ──▶ $CLST holders paid pro-rata

Holding is the position. Every cycle is public: GET /api/distributions.

Integrations

Project	Role	Guide
Hindsight	learning memory backend (observations, mental models)	`skills/memory/`
OpenBB	institutional market data (fundamentals, macro) via MCP/Python	`skills/research/`
Maybe	self-hosted personal finance UI (AGPLv3 — rename your fork)	`skills/finance/`
OpenCatz	multi-agent scout swarm pattern on 4663	`skills/crypto-intel/`
Uniswap AI	skills architecture this repo follows	structure

The Agents

Trading Relay · Pivot — Research Scout · Sifter · Quill — Analysis Argus · Prism · Census — Finance Ledger · Remit · Margin — Memory Memoria · Echo — Crypto Nexus · Vault · Oracle

Honesty by Construction

Pre-launch payout data = honest zeros, never fabricated
Swaps: API quotes, your wallet signs — no private keys server-side
Keys: SHA-256 at rest, shown once
Quote = prediction; receipt = proof (parse the Transfer logs)

License

MIT. Backend and skills are original work. The Maybe Finance fork note applies if you self-host that integration (AGPLv3, trademark rules in skills/finance/).

Cluster

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Cluster?

Does Cluster need an API key?

What transport does Cluster use?

When was Cluster last checked?

Documentation

cluster

Repo Layout

Quick Start

The Mechanism

Integrations

The Agents

Honesty by Construction

License