English Français العربية

dev.clusteragent/cluster-mcp

Registre officiel Finance et paiements

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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)>'
Configuration JSON (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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

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

Questions fréquentes

Qu'est-ce que dev.clusteragent/cluster-mcp ?

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

Comment installer dev.clusteragent/cluster-mcp ?

Il fonctionne comme serveur distant. Dans 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)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour dev.clusteragent/cluster-mcp ?

Oui. Il attend CLUSTER_API_KEY, Authorization, à renseigner dans sa configuration.

dev.clusteragent/cluster-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient dev.clusteragent/cluster-mcp ?

Il est publié par clusteragent. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.