English Français العربية

dev.clusteragent/cluster-mcp

Official registry Finance and payments

Self-hostable index of AI financial agents — tokenized stocks + crypto, memory, LLM gateway.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http cluster-mcp 'https://mcp.clusteragent.dev/mcp' --header 'Authorization: <Bearer clst_... API key minted via wallet signature (see /api/keys)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cluster-mcp": {
            "type": "http",
            "url": "https://mcp.clusteragent.dev/mcp",
            "headers": {
                "Authorization": "<Bearer clst_... API key minted via wallet signature (see /api/keys)>"
            }
        }
    }
}
NPM package @clusteragent/cluster-mcp
Claude Code 
claude mcp add cluster-mcp -e 'CLUSTER_API_URL=<CLUSTER_API_URL>' -e 'CLUSTER_API_KEY=<your cluster_api_key>' -e 'CLUSTER_WALLET=<CLUSTER_WALLET>' -- npx -y @clusteragent/cluster-mcp@1.0.12
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cluster-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@clusteragent/cluster-mcp@1.0.12"
            ],
            "env": {
                "CLUSTER_API_URL": "<CLUSTER_API_URL>",
                "CLUSTER_API_KEY": "<your cluster_api_key>",
                "CLUSTER_WALLET": "<CLUSTER_WALLET>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. cluster
  2. Repo Layout
  3. Quick Start
  4. The Mechanism
  5. Integrations
  6. The Agents
  7. Honesty by Construction
  8. License

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

ProjectRoleGuide
Hindsightlearning memory backend (observations, mental models)skills/memory/
OpenBBinstitutional market data (fundamentals, macro) via MCP/Pythonskills/research/
Maybeself-hosted personal finance UI (AGPLv3 — rename your fork)skills/finance/
OpenCatzmulti-agent scout swarm pattern on 4663skills/crypto-intel/
Uniswap AIskills architecture this repo followsstructure

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/).

Frequently asked questions

What is dev.clusteragent/cluster-mcp?

Self-hostable index of AI financial agents — tokenized stocks + crypto, memory, LLM gateway.

How do I install dev.clusteragent/cluster-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http cluster-mcp 'https://mcp.clusteragent.dev/mcp' --header 'Authorization: <Bearer clst_... API key minted via wallet signature (see /api/keys)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does dev.clusteragent/cluster-mcp need an API key?

Yes. It expects CLUSTER_API_KEY, Authorization, which you set in its configuration.

Is dev.clusteragent/cluster-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains dev.clusteragent/cluster-mcp?

It is published by clusteragent. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.