{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_guz8vtj9mhhx","handle":"bithuman-mcp","url":"https://wellknown.network/agents/bithuman-mcp","links":{"self":"https://wellknown.network/agents/bithuman-mcp/record.json","html":"https://wellknown.network/agents/bithuman-mcp","markdown":"https://wellknown.network/agents/bithuman-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bithuman-mcp","status":"https://wellknown.network/api/v1/agents/bithuman-mcp/status","claim":"https://wellknown.network/agents/bithuman-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bithuman-mcp/claim.json","badge":"https://wellknown.network/agents/bithuman-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/bithuman-mcp/history","tools":"https://wellknown.network/api/v1/agents/bithuman-mcp/tools"},"ard":{"identifier":"urn:air::server:bithuman-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bithuman-mcp","summary":"DEPRECATED — use `bithuman mcp` in the bitHuman CLI. MCP server for the bitHuman AI avatar platform.","description":"# bitHuman MCP server\n\n> [!IMPORTANT]\n> **Deprecated — use the bitHuman CLI instead.** This server is now built into\n> the [`bithuman` CLI](https://github.com/bithuman-product/homebrew-bithuman):\n> run **`bithuman mcp`**. It exposes the same tools (identical names) plus local\n> ones (`version`, `doctor`, `inspect_model`, `list_showcase`), so you install\n> **one** tool. Migrate your MCP client config:\n>\n> ```json\n> { \"mcpServers\": { \"bithuman\": { \"command\": \"bithuman\", \"args\": [\"mcp\"] } } }\n> ```\n>\n> Install the CLI: `brew install bithuman-product/bithuman/bithuman-cli` (macOS) or the universal installer\n> (macOS + Linux) — see the CLI README. This `bithuman-mcp` package will receive\n> no further updates.\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that exposes\nthe [bitHuman](https://bithuman.ai) avatar platform as tools any MCP-capable AI\nagent can call — Claude Desktop, Claude Code, Cursor, and others.\n\nIt's a thin, fully-documented wrapper over the public REST API\n(`https://api.bithuman.ai`). Every tool maps to one documented endpoint; see the\n[API docs](https://docs.bithuman.ai/api/overview) and the\n[OpenAPI spec](https://docs.bithuman.ai/api/openapi.yaml).\n\n## Tools\n\nThe server exposes **22 tools**, each mapping to one documented REST endpoint\n(plus `get_platform_status`, which reads the public status feed):\n\n| Tool | What it does |\n|------|--------------|\n| `get_platform_status` | Live platform + API status (public, no key). |\n| `validate_api_secret` | Check the API secret is valid (free). |\n| `get_credit_balance` | Current credits, plan, and minutes estimate. |\n| `get_usage` | Usage/metering history (paginated, date-filterable). |\n| `list_voices` | Built-in (M1–M5 / F1–F5) and custom TTS voices. |\n| `text_to_speech` | Synthesize speech → a WAV file. |\n| `generate_agent` | Create an avatar agent from a prompt / image / audio (image-only appearance; `model`+`version` select the engine, e.g. essence + v2 = essence-2). |\n| `get_agent_statu…","publisher":null,"homepage":"https://docs.bithuman.ai","repository":"https://github.com/bithuman-product/homebrew-bithuman/tree/main/packages/python-mcp","version":"0.3.5","license":"Apache-2.0","protocols":["mcp"],"tags":["agent","ai","avatar","bithuman","mcp","model-context-protocol","tts"],"pricing":null,"endpoints":[{"url":"pypi:bithuman-mcp","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"}},"derived":{"capabilities":[{"slug":"media.speech-synthesis","name":"Speech Synthesis","confidence":1,"provenance":"declared"},{"slug":"data.apis","name":"API Access","confidence":0.814,"provenance":"derived"},{"slug":"code.documentation","name":"Code Documentation","confidence":0.802,"provenance":"derived"}],"categories":["code","data","media"],"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":"bithuman-mcp","registry":"pypi","observedAt":"2026-09-15T10:22:15.552Z","publishedAt":"2026-08-02T05:16:23.729132Z","latestVersion":"0.3.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bithuman-mcp","url":"https://pypi.org/project/bithuman-mcp/","firstSeenAt":"2026-09-09T10:27:17.935Z","fetchedAt":"2026-09-15T10:20:59.753Z","normalizedAt":"2026-09-15T10:20:59.753Z"}]},"firstSeenAt":"2026-09-09T10:27:17.935Z","updatedAt":"2026-09-15T10:22:15.552Z"}