{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_te8fad4wd67p","handle":"amgi-mcp","url":"https://wellknown.network/agents/amgi-mcp","links":{"self":"https://wellknown.network/agents/amgi-mcp/record.json","html":"https://wellknown.network/agents/amgi-mcp","markdown":"https://wellknown.network/agents/amgi-mcp/record.md","api":"https://wellknown.network/api/v1/agents/amgi-mcp","status":"https://wellknown.network/api/v1/agents/amgi-mcp/status","claim":"https://wellknown.network/agents/amgi-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/amgi-mcp/claim.json","badge":"https://wellknown.network/agents/amgi-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:amgi-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"amgi-mcp","summary":"Amgi MCP server — Python shim for uvx. Launches the bundled Amgi helper.","description":"# amgi-mcp (Python shim for `uvx`)\n\nThis is a tiny Python wrapper that makes the Amgi MCP server runnable via [`uvx`](https://docs.astral.sh/uv/guides/tools/#running-tools-with-uvx) — the pattern many MCP clients expect:\n\n```\nCommand: uvx\nParameters: amgi-mcp\n```\n\nThe Swift helper is still the real server; this package just finds the bundled binary at `/Applications/AmgiApp.app/Contents/Helpers/amgi-mcp` (or the dev helpers in `~/bin`, `/usr/local/bin`, `DerivedData`) and `exec`s it, forwarding stdio.\n\n`uvx` (`uv tool run`) holds the uv cache lock for the lifetime of the server (`astral-sh/uv#15990`). With several clients all using `uvx` the spawns serialize and can hit the 10 s handshake timeout. For multi-client / daily use install once persistently.\n\n## Install / run\n\n```sh\n# One-off / trial — no install, uses cached env after first run:\nuvx amgi-mcp --help\n# Pin for reproducibility:\nuvx amgi-mcp==1.0.2 --help\n\n# Daily / multi-client — persistent, fastest, no cache-lock contention:\nuv tool install amgi-mcp\namgi-mcp --help\n\n# Update the persistent install:\nuv tool upgrade amgi-mcp\n```\n\nLocal development (no PyPI):\n\n```sh\nuvx --from ./python amgi-mcp --help\nuv tool install --from ./python amgi-mcp\n```\n\nAll arguments are passed through, so tier/profile flags still work:\n\n```sh\namgi-mcp --help\namgi-mcp --profile work\n```\n\n### Troubleshooting: `uvx` timeout or `Waiting to acquire lock`\n\nIf several AI clients launch `uvx amgi-mcp` at once and one times out, either switch that client to the persistent `amgi-mcp` command or re-run the failing `uvx` once - `uv cache` is shared and `uvx` retains a shared lock for the server lifetime. `uv tool install` avoids the lock entirely.","publisher":{"name":"Amgi","url":null},"homepage":"https://github.com/bagumamartin/amgi","repository":"https://github.com/bagumamartin/amgi","version":"1.0.2","license":"AGPL-3.0","protocols":["mcp"],"tags":["amgi","anki","mcp"],"pricing":null,"endpoints":[{"url":"pypi:amgi-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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"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":"amgi-mcp","registry":"pypi","observedAt":"2026-09-09T09:24:48.333Z","publishedAt":"2026-08-24T17:40:51.497836Z","latestVersion":"1.0.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"amgi-mcp","url":"https://pypi.org/project/amgi-mcp/","firstSeenAt":"2026-09-09T09:22:44.897Z","fetchedAt":"2026-09-09T09:22:44.897Z","normalizedAt":"2026-09-09T09:22:44.897Z"}]},"firstSeenAt":"2026-09-09T09:22:44.897Z","updatedAt":"2026-09-09T09:24:48.333Z"}