{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9mu3g3nb56c5","handle":"zotero-api-mcp","url":"https://wellknown.network/agents/zotero-api-mcp","links":{"self":"https://wellknown.network/agents/zotero-api-mcp/record.json","html":"https://wellknown.network/agents/zotero-api-mcp","markdown":"https://wellknown.network/agents/zotero-api-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zotero-api-mcp","status":"https://wellknown.network/api/v1/agents/zotero-api-mcp/status","claim":"https://wellknown.network/agents/zotero-api-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zotero-api-mcp/claim.json","badge":"https://wellknown.network/agents/zotero-api-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zotero-api-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zotero-api-mcp","summary":"A clean, one-to-one MCP server for the Zotero API, just the API","description":"# zotero-api-mcp\n\nA clean, one-to-one MCP server for the Zotero API, just the API.\n\n## Features\n\n- **22 MCP tools** covering the full Zotero API surface\n- **Local API** support (`ZOTERO_LOCAL=true`) — no API key needed\n- **Web API** support with interactive setup wizard\n- **Full CRUD**: create items by DOI, arXiv, ISBN; update metadata; delete to trash\n- **Collections**: create, add/remove items, search\n- **Notes & Annotations**: read, create\n- **Attachments**: add files or URLs, read metadata\n- **Library management**: stats, trash, groups, tags\n- **Secure by default**: API key stored with `SecretStr`, XML parsing via `defusedxml`\n- **Configuration**: `.env` file support with `ZOTERO_` prefix, `pydantic-settings`\n- **Multi-library support**: Query any group or user library per-call without reconfiguring\n\n## Multi-Library Support\n\nAll tools accept optional `library_id` and `library_type` keyword parameters to override the default library configured in your environment. This lets you query multiple Zotero group libraries without restarting the server or changing your `.env` file.\n\n**Example**: Query a group library from any tool:\n\n```\nzotero_search_items(query=\"machine learning\", library_id=\"<group-id>\", library_type=\"group\")\nzotero_get_item(\"ABC12345\", library_id=\"<group-id>\", library_type=\"group\")\nzotero_get_collection_items(\"XYZ99999\", library_id=\"<group-id>\", library_type=\"group\")\n```\n\n- `library_id` — The Zotero library ID (user ID or group ID)\n- `library_type` — Either `\"user\"` or `\"group\"`\n- Both default to your configured `ZOTERO_LIBRARY_ID` / `ZOTERO_LIBRARY_TYPE` when omitted\n- Works with all 22 tools — search, items, collections, notes, annotations, and attachments\n- Stateless: each call is independent, no session-level switching needed\n\n## Quick Start\n\n```bash\n# Run directly (auto-installs)\nuvx zotero-api-mcp serve\n\n# Or install globally\nuv tool install zotero-api-mcp\nzotero-api-mcp serve\n```\n\n### Local Mode (no API key)\n\nSet the environment variable and …","publisher":null,"homepage":"https://github.com/siebert-julien/zotero-api-mcp","repository":"https://github.com/siebert-julien/zotero-api-mcp","version":"0.0.4","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","reference-manager","zotero"],"pricing":null,"endpoints":[{"url":"pypi:zotero-api-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":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.694,"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":"zotero-api-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:37.896Z","publishedAt":"2026-07-17T14:10:34.242627Z","latestVersion":"0.0.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zotero-api-mcp","url":"https://pypi.org/project/zotero-api-mcp/","firstSeenAt":"2026-09-10T16:24:03.516Z","fetchedAt":"2026-09-10T16:24:03.516Z","normalizedAt":"2026-09-10T16:24:03.516Z"}]},"firstSeenAt":"2026-09-10T16:24:03.516Z","updatedAt":"2026-09-10T16:24:37.896Z"}