{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kq7fwkkupfzs","handle":"mcp-host-agent","url":"https://wellknown.network/agents/mcp-host-agent","links":{"self":"https://wellknown.network/agents/mcp-host-agent/record.json","html":"https://wellknown.network/agents/mcp-host-agent","markdown":"https://wellknown.network/agents/mcp-host-agent/record.md","api":"https://wellknown.network/api/v1/agents/mcp-host-agent","status":"https://wellknown.network/api/v1/agents/mcp-host-agent/status","claim":"https://wellknown.network/agents/mcp-host-agent/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-host-agent/claim.json","badge":"https://wellknown.network/agents/mcp-host-agent/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-host-agent/history","tools":"https://wellknown.network/api/v1/agents/mcp-host-agent/tools"},"ard":{"identifier":"urn:air::server:mcp-host-agent","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-host-agent","summary":"Host-level deployment and supervision agent for the MCP Worker platform: manage local Worker services (git/pip/systemd/launchd), health polling, heartbeat aggregation, and self-healing.","description":"# mcp-host-agent\n\n<div align=\"center\">\n\n**The host-level deployment & supervision agent for the MCP Worker platform.**\n\nInstall once per host, manage every local Worker service end to end —\ndeployment, health polling, heartbeat aggregation, crash self-healing, and\nGit-service-driven continuous delivery.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-host-agent)](https://pypi.org/project/mcp-host-agent/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-host-agent)](https://pypi.org/project/mcp-host-agent/)\n[![License](https://img.shields.io/pypi/l/mcp-host-agent)](https://opensource.org/licenses/Apache-2.0)\n\n</div>\n\n---\n\n## What this is\n\n`mcp-host-agent` is a **system CLI you install** — not a Python project you write.\nThe thing you build is a **Worker** (a small\n[`mcp-worker-sdk`](https://pypi.org/project/mcp-worker-sdk/) repo exposing\n`/health /tools /execute /meta`). This CLI points at your Worker's Git repo and\ndoes the clone / install / run / supervise / heal for you.\n\nSo no “worker directory structure” lives here — that belongs to\n[`mcp-worker-sdk`](https://pypi.org/project/mcp-worker-sdk/).\n\n## Built on\n\n| Layer | Technology |\n|-------|-----------|\n| Runtime | Python 3.10+ |\n| Control plane (HTTP API) | FastAPI + uvicorn |\n| Worker deployment | subprocess — `git` / `pip` / `systemctl` / `launchctl` |\n| Config & validation | pydantic + PyYAML |\n| Hub / Worker polling | httpx |\n| Shared protocol | [`mcp-worker-protocol`](https://pypi.org/project/mcp-worker-protocol/) |\n\n---\n\n## Why\n\nDeploying MCP Workers by hand means writing the same `git clone + pip install +\nsystemctl restart + heartbeat + self-healing` glue every time — multiplied by the\nnumber of Workers and hosts you manage. `mcp-host-agent` turns that glue into a\nsingle, declarative, docker-style CLI.\n\n- **One agent per host** manages **N Worker services**.\n- **Coolify-like Git UX** — private/public Git repos plus push-to-deploy webhooks.\n- **Rich three-tier health** — status, queue backpressure, and l…","publisher":{"name":"Mavis AI Platform","url":null},"homepage":null,"repository":null,"version":"1.1.5","license":"Apache-2.0","protocols":["mcp"],"tags":["mcp","host-agent","worker","deployment","supervision","self-healing"],"pricing":null,"endpoints":[{"url":"pypi:mcp-host-agent","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"declared"},{"slug":"communication.notifications","name":"Notifications","confidence":0.768,"provenance":"derived"}],"categories":["communication","dev"],"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-host-agent","registry":"pypi","observedAt":"2026-10-28T11:27:24.664Z","publishedAt":"2026-08-18T12:53:05.002450Z","latestVersion":"1.1.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-host-agent","url":"https://pypi.org/project/mcp-host-agent/","firstSeenAt":"2026-09-10T02:22:43.912Z","fetchedAt":"2026-10-28T11:26:31.963Z","normalizedAt":"2026-10-28T11:26:31.963Z"}]},"firstSeenAt":"2026-09-10T02:22:43.912Z","updatedAt":"2026-10-28T11:27:24.664Z"}