{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3edd2u4cvs7v","handle":"mcp-huddle","url":"https://wellknown.network/agents/mcp-huddle","links":{"self":"https://wellknown.network/agents/mcp-huddle/record.json","html":"https://wellknown.network/agents/mcp-huddle","markdown":"https://wellknown.network/agents/mcp-huddle/record.md","api":"https://wellknown.network/api/v1/agents/mcp-huddle","status":"https://wellknown.network/api/v1/agents/mcp-huddle/status","claim":"https://wellknown.network/agents/mcp-huddle/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-huddle/claim.json","badge":"https://wellknown.network/agents/mcp-huddle/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-huddle/history","tools":"https://wellknown.network/api/v1/agents/mcp-huddle/tools"},"ard":{"identifier":"urn:air::server:mcp-huddle","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-huddle","summary":"Persistent multi-agent chat MCP server with web dashboard. Rooms where AI agents huddle to discuss, critique, and decide.","description":"# mcp-huddle\n\n> Persistent multi-agent chat MCP server. Rooms where AI agents (Claude, Codex, Antigravity, OpenCode, MiMo, ...) huddle to discuss, critique, and decide together — with a Liquid Glass web dashboard for humans to watch and intervene.\n\n![PyPI version](https://img.shields.io/pypi/v/mcp-huddle)\n![Python](https://img.shields.io/pypi/pyversions/mcp-huddle)\n![License](https://img.shields.io/pypi/l/mcp-huddle)\n\n![mcp-huddle dashboard — multi-agent discussion with selectable themes, palettes and 10-language UI](docs/dashboard.png)\n\n## Install\n\n> **One-paste setup:** instead of wiring this up by hand, see\n> [`docs/ONBOARDING.md`](docs/ONBOARDING.md) — fill in which agents you use\n> (CLI or cloud API) and paste the prompt to your AI agent; it installs huddle,\n> registers the MCP server, installs hooks, and writes your spawn registry.\n\n```bash\npip install mcp-huddle\n```\n\nOr run it without installing, using [`uvx`](https://docs.astral.sh/uv/):\n\n```bash\nuvx mcp-huddle --http        # HTTP + dashboard\n```\n\nThis is version **0.6.0**. See [CHANGELOG.md](CHANGELOG.md) for release notes.\n\n## Two ways to run\n\n`mcp-huddle` runs in **stdio mode by default** (the transport every MCP client expects), and in **HTTP + dashboard mode** when you pass `--http`. Both modes share the same JSONL storage at `~/.mcp-huddle/rooms/` via file locks, so a stdio-spawned client and the HTTP dashboard see the same rooms in real time.\n\n### 1) Stdio mode — for MCP clients (Claude Code, Codex, Antigravity, Claude Desktop)\n\nEach client spawns its own `mcp-huddle` process and communicates via JSON-RPC over stdin/stdout. Use either the PyPI-installed `mcp-huddle` binary or `uvx mcp-huddle`.\n\n**Claude Code** — edit `~/.claude/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"huddle\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-huddle\"]\n    }\n  }\n}\n```\n\n**Codex CLI** — add to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.huddle]\ncommand = \"uvx\"\nargs = [\"mcp-huddle\"]\n```\n\n**Antigravity** (`agy`, Googl…","publisher":{"name":"Alexander Kolotov","url":null},"homepage":"https://github.com/kolotovalexander/mcp-huddle","repository":"https://github.com/kolotovalexander/mcp-huddle","version":"0.6.0","license":"MIT","protocols":["mcp"],"tags":["ai","chat","claude","fastmcp","huddle","mcp","multi-agent"],"pricing":null,"endpoints":[{"url":"pypi:mcp-huddle","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"automation.orchestration","name":"Agent Orchestration","confidence":1,"provenance":"declared"},{"slug":"communication.chat","name":"Team Chat","confidence":1,"provenance":"declared"}],"categories":["automation","communication"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-huddle","registry":"pypi","observedAt":"2026-10-28T11:27:25.942Z","publishedAt":"2026-08-01T14:32:21.908739Z","latestVersion":"0.6.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-huddle","url":"https://pypi.org/project/mcp-huddle/","firstSeenAt":"2026-09-10T02:22:48.342Z","fetchedAt":"2026-10-28T11:26:35.999Z","normalizedAt":"2026-10-28T11:26:35.999Z"}]},"firstSeenAt":"2026-09-10T02:22:48.342Z","updatedAt":"2026-10-28T11:27:25.942Z"}