{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_sydspakdv7sw","handle":"maki-mcp","url":"https://wellknown.network/agents/maki-mcp","links":{"self":"https://wellknown.network/agents/maki-mcp/record.json","html":"https://wellknown.network/agents/maki-mcp","markdown":"https://wellknown.network/agents/maki-mcp/record.md","api":"https://wellknown.network/api/v1/agents/maki-mcp","status":"https://wellknown.network/api/v1/agents/maki-mcp/status","claim":"https://wellknown.network/agents/maki-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/maki-mcp/claim.json","badge":"https://wellknown.network/agents/maki-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/maki-mcp/history","tools":"https://wellknown.network/api/v1/agents/maki-mcp/tools"},"ard":{"identifier":"urn:air::server:maki-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"maki-mcp","summary":"Run dev commands and expose their logs over MCP.","description":"# maki\n\nRun a dev command, save its terminal output per project, and let MCP-capable agents read the logs without copy/paste.\n\n```bash\nmaki --name dev pnpm dev\n```\n\nThen ask your agent:\n\n> Check the maki dev logs and fix the error.\n\n## How it works\n\n```text\nmaki --name dev pnpm dev\n  ├─ runs pnpm dev\n  ├─ prints output to your terminal\n  └─ writes logs to .maki/runs/<run-id>.log\n\nmaki-mcp --project /path/to/project\n  └─ exposes MCP tools that read .maki logs\n```\n\nEach run gets:\n\n```text\n.maki/\n  active.json\n  runs/\n    20260710-090000-a1b2c3.log\n    20260710-090000-a1b2c3.json\n```\n\nThe run id is timestamp + random suffix. `--name` is the human label agents can use, like `dev`, `api`, `web`, or `worker`.\n\n## Install\n\nRecommended:\n\n```bash\npipx install maki-mcp\n```\n\nor:\n\n```bash\nuv tool install maki-mcp\n```\n\nOn Windows without pipx:\n\n```powershell\npy -m pip install --user pipx\npy -m pipx ensurepath\npipx install maki-mcp\n```\n\nAvoid system-wide `pip install maki-mcp`. Some Python installs, like Homebrew Python, block it with an \"externally managed environment\" error. `pipx`/`uv tool` install maki as a CLI without touching system Python.\n\nMaki works in any project, not just Python projects:\n\n```bash\ncd my-node-app\nmaki --name dev pnpm dev\n```\n\nThe package is `maki-mcp`, but the commands are:\n\n```bash\nmaki\nmaki-mcp\n```\n\n## Usage\n\nStart your app through maki:\n\n```bash\nmaki --name dev pnpm dev\nmaki --name api npm run api\nmaki --name worker python worker.py\n```\n\nIf you omit `--name`, it defaults to `dev`:\n\n```bash\nmaki pnpm dev\n```\n\nStart the MCP server for that project:\n\n```bash\nmaki-mcp --project /path/to/project\n```\n\nMCP tools:\n\n- `list_runs()`\n- `latest_logs(name=\"dev\", lines=200)`\n- `get_log(run_id=\"...\", lines=200)`\n\n## MCP config\n\nUse stdio transport. No port needed.\n\n### Claude Code\n\nCLI:\n\n```bash\nclaude mcp add maki -- maki-mcp --project /path/to/project\n```\n\nConfig shape:\n\n```json\n{\n  \"mcpServers\": {\n    \"maki\": {\n      \"command\": \"maki-mcp\",\n      \"args\": [\"--pro…","publisher":null,"homepage":null,"repository":null,"version":"0.2.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:maki-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":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.756,"provenance":"derived"}],"categories":["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":"maki-mcp","registry":"pypi","observedAt":"2026-10-28T09:23:05.680Z","publishedAt":"2026-07-10T10:06:21.882508Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"maki-mcp","url":"https://pypi.org/project/maki-mcp/","firstSeenAt":"2026-09-09T23:26:38.330Z","fetchedAt":"2026-10-28T09:21:47.059Z","normalizedAt":"2026-10-28T09:21:47.059Z"}]},"firstSeenAt":"2026-09-09T23:26:38.330Z","updatedAt":"2026-10-28T09:23:05.680Z"}