{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rbynxp6syzae","handle":"agent-hub-mcp","url":"https://wellknown.network/agents/agent-hub-mcp","links":{"self":"https://wellknown.network/agents/agent-hub-mcp/record.json","html":"https://wellknown.network/agents/agent-hub-mcp","markdown":"https://wellknown.network/agents/agent-hub-mcp/record.md","api":"https://wellknown.network/api/v1/agents/agent-hub-mcp","status":"https://wellknown.network/api/v1/agents/agent-hub-mcp/status","claim":"https://wellknown.network/agents/agent-hub-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/agent-hub-mcp/claim.json","badge":"https://wellknown.network/agents/agent-hub-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:agent-hub-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"agent-hub-mcp","summary":"Agent Hub MCP — multi-agent task coordination with MCP transport","description":"# Agent Hub MCP\n\n**English** | [中文](README_CN.md)\n\n> Multi-agent task coordination server built on the [Model Context Protocol](https://modelcontextprotocol.io/)\n\nAgent Hub is a lightweight coordination layer for multi-agent workflows. It provides structured task dispatch, assignment tracking, inter-agent messaging, handoff documents, and human-in-the-loop approval — all accessible via the MCP protocol.\n\n## ✨ Features\n\n- 🔌 **MCP Streamable HTTP** — any MCP client connects directly\n- 📋 **Task → Round → Assignment** state machine with operator approval gates\n- 💬 **Inter-agent messaging** with deduplication and inbox pull\n- 🤝 **Structured handoff documents** — agents pass work with context, not just messages\n- 🔒 **Distributed locks** with TTL-based lease expiry\n- 🛡️ **Bearer token authentication** — each agent authenticates independently\n- 📦 **Zero-dependency database** — SQLite with WAL mode, no external DB needed\n- ⚡ **5-minute setup** — install, configure tokens, run\n\n## 🚀 Quick Start\n\n### Install\n\n```bash\n# Install from PyPI (recommended)\npip install agent-hub-mcp\n\n# Or install from source\ngit clone https://github.com/mazhengeod/agent-hub.git\ncd agent-hub\npip install -e .\n```\n\n### Configure Agent Tokens\n\nCreate `~/.config/agent-hub/agents.env`:\n\n```env\n# Format: AGENT_ID=BEARER_TOKEN\nclaude-code=your-secret-token-here\ncodex-desktop=another-secret-token\n```\n\nOptionally, create `~/.config/agent-hub/config.yaml` for tuning:\n\n```yaml\nmax_rounds: 3\nmax_assignments_per_round: 6\nmax_messages_per_task: 40\nlease_minutes: 90\n```\n\n### Run\n\n```bash\n# Start the MCP server (defaults to 127.0.0.1:8765)\npython -m agent_hub.server\n\n# Or use the CLI\nhubctl serve\n```\n\n### Connect from Claude Code\n\nAdd to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-hub\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"http://127.0.0.1:8765/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-secret-token-here\"\n      }\n    }\n  }\n}\n```\n\nAfter the MCP client co…","publisher":null,"homepage":null,"repository":null,"version":"0.2.1","license":null,"protocols":["mcp"],"tags":["agent-hub","mcp","multi-agent","task-coordination"],"pricing":null,"endpoints":[{"url":"pypi:agent-hub-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"automation.orchestration","name":"Agent Orchestration","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.917,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.802,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["automation","data","dev","security"],"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":"agent-hub-mcp","registry":"pypi","observedAt":"2026-09-09T08:22:29.376Z","publishedAt":"2026-06-06T07:20:03.379045Z","latestVersion":"0.2.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"agent-hub-mcp","url":"https://pypi.org/project/agent-hub-mcp/","firstSeenAt":"2026-09-09T08:20:56.911Z","fetchedAt":"2026-09-09T08:20:56.911Z","normalizedAt":"2026-09-09T08:20:56.911Z"}]},"firstSeenAt":"2026-09-09T08:20:56.911Z","updatedAt":"2026-09-09T08:22:29.376Z"}