{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wns763g7tvr5","handle":"guild-mcp","url":"https://wellknown.network/agents/guild-mcp","links":{"self":"https://wellknown.network/agents/guild-mcp/record.json","html":"https://wellknown.network/agents/guild-mcp","markdown":"https://wellknown.network/agents/guild-mcp/record.md","api":"https://wellknown.network/api/v1/agents/guild-mcp","status":"https://wellknown.network/api/v1/agents/guild-mcp/status","claim":"https://wellknown.network/agents/guild-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/guild-mcp/claim.json","badge":"https://wellknown.network/agents/guild-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/guild-mcp/history","tools":"https://wellknown.network/api/v1/agents/guild-mcp/tools"},"ard":{"identifier":"urn:air::server:guild-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"guild-mcp","summary":"Guild MCP Server — AI Guild workflow pack tools via Model Context Protocol","description":"# Guild MCP Server\n\nAI Guild workflow pack tools via Model Context Protocol (JSON-RPC 2.0 over stdio).\n\nExposes guild tools to external agents that communicate via the MCP protocol.\n\n## Tools Exposed\n\n| Tool | Description |\n|------|-------------|\n| `guild_search` | Search for guild workflow packs by keyword |\n| `guild_pull` | Fetch, validate, and store a pack locally |\n| `guild_try` | Preview a pack without saving it |\n| `guild_apply` | Execute a pack with phase tracking (start/checkpoint/complete) |\n| `guild_publish` | Publish a pack or feedback to the guild repo |\n| `guild_keygen` | Generate Ed25519 signing key for agent authentication |\n| `guild_sign` | Sign a content hash with Ed25519 private key |\n\n## Installation\n\n### From source\n\n```bash\ncd /root/hermes-workspace/guild-mcp-package\npip install -e .\n```\n\n### Dependencies\n\n- Python 3.10+\n- `pyyaml>=6.0`\n- `pynacl>=1.5.0` (optional, for key generation/signing)\n\n## MCP Client Configuration\n\n### Claude Code\n\nAdd to your `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"guild\": {\n      \"command\": \"guild-mcp\"\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nConfigure your MCP client to spawn `guild-mcp` as a subprocess:\n\n```json\n{\n  \"mcpServers\": {\n    \"guild\": {\n      \"command\": \"guild-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n## CLI Usage\n\n### Start the server (stdio mode)\n\n```bash\nguild-mcp\n```\n\nThe server reads JSON-RPC requests from stdin and writes responses to stdout.\n\n### Python client library\n\n```python\nfrom guild_mcp.client import GuildMCPClient\n\n# Using context manager\nwith GuildMCPClient() as client:\n    # Search for packs\n    result = client.call_tool(\"guild_search\", {\"query\": \"debugging\"})\n    print(result)\n\n    # Pull a pack\n    result = client.call_tool(\"guild_pull\", {\"uri\": \"guild://hermes/systematic-debugging\"})\n\n    # Apply a pack\n    result = client.call_tool(\"guild_apply\", {\n        \"action\": \"start\",\n        \"pack_name\": \"systematic-debugging\",\n        \"task\": \"Fix login bug in auth module\"\n    }…","publisher":null,"homepage":"https://github.com/hermes-agent/guild-mcp","repository":"https://github.com/hermes-agent/guild-mcp","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["guild","mcp","workflow","pack","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:guild-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"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":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["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":"guild-mcp","registry":"pypi","observedAt":"2026-11-09T06:27:52.686Z","publishedAt":"2026-03-26T11:00:39.928411Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"guild-mcp","url":"https://pypi.org/project/guild-mcp/","firstSeenAt":"2026-09-09T17:20:23.888Z","fetchedAt":"2026-11-09T06:26:35.151Z","normalizedAt":"2026-11-09T06:26:35.151Z"}]},"firstSeenAt":"2026-09-09T17:20:23.888Z","updatedAt":"2026-11-09T06:27:52.686Z"}