JSON-Rohbericht maschinenlesbar
{
"data": {
"repo": {
"topics": [
"ai",
"document-management",
"mcp",
"mcp-server",
"paperless-ngx"
],
"is_fork": true,
"size_kb": 361,
"has_wiki": false,
"homepage": null,
"languages": {
"Dockerfile": 490,
"JavaScript": 6395,
"TypeScript": 193822
},
"pushed_at": "2026-07-23T16:22:13Z",
"created_at": "2025-05-12T05:22:52Z",
"owner_type": "User",
"updated_at": "2026-07-31T14:27:04Z",
"description": "An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.",
"is_archived": false,
"is_disabled": false,
"license_spdx": "ISC",
"default_branch": "main",
"license_spdx_raw": "ISC",
"primary_language": "TypeScript",
"significant_languages": [
"TypeScript"
]
},
"owner": {
"blog": "https://baruchiro.com/",
"name": "Baruch Odem (Rothkoff)",
"type": "User",
"login": "baruchiro",
"company": "@with-org",
"location": "Israel",
"followers": 80,
"avatar_url": "https://avatars.githubusercontent.com/u/17686879?v=4",
"created_at": "2016-03-06T13:55:11Z",
"is_verified": null,
"public_repos": 168,
"account_age_days": 3800
},
"license": {
"state": "standard",
"spdx_id": "ISC",
"raw_spdx": "ISC",
"file_present": true,
"scorecard_found": true,
"profile_has_license": false
},
"activity": {
"releases": [],
"recent_commits": [
{
"oid": "53c4b0b7c1893d2b100592d0a036ce7cc5651388",
"body": "…#133)\n\n- Install npm into a separate prefix (npm@^11.5.1) and prepend it to PATH instead of overwriting the running npm, avoiding the mid-reify \"Cannot find module 'promise-retry'\" crash.\n- Publish via `npx --no-install changeset publish` so a changeset-less push to main is a clean no-op instead of\n[…]\nlic in the changesets config.\n- Emit an empty version tag on no-op runs and gate docker-publish on a non-empty versionTag.\n- Pass publishedPackages through env to avoid the template-injection pattern.",
"is_bot": false,
"headline": "fix(release): harden npm upgrade and publishing in release workflow (…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-07-23T16:22:11Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ccea28b7957fb193dd7673454f76eb0ef91e6f1a",
"body": "## Summary\nUpgrades all GitHub Actions workflows to versions that run on Node.js\n24, resolving deprecation warnings from the Node.js 20 EOL on GitHub\nrunners.\n\n## Changes\n- **actions/checkout**: v4 → v5\n- **actions/stale**: v9 → v10\n- **docker/setup-qemu-action**: v3 → v4\n- **docker/setup-buildx-act\n[…]\ntem management automation while preserving its existing\nconfiguration.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Upgrade GitHub Actions to Node.js 24 compatible versions (#132)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-07-23T12:48:28Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b66ac72cec4673704a245480921e95b05260ccd1",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\ns against both a 2.x and the latest 3.x\nPaperless image to guard against version-compatibility regressions.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#131)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-07-23T06:47:35Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "700c0559dd361ec53b343ab97b626455585b42e6",
"body": "The custom_fields array in update_document is sent verbatim in the\nPATCH request, so Paperless replaces the document's entire custom-field\nset — any omitted field is cleared. The tool and parameter descriptions\npreviously implied partial-update semantics (\"Only the fields you\nspecify will be updated\n[…]\nmended approaches for partial custom-field updates\nthat preserve existing fields.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: clarify update_document custom_fields replace semantics (#128)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-07-23T06:40:18Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "c3e0a491aeb3454f005a787bb993c505c5d0e4da",
"body": "Paperless-ngx v3.0.0 dropped support for REST API versions below 9 and\nnow returns HTTP 406 for the previous default (version 5), breaking\nevery\nrequest against v3+ servers. Version 9 is supported on both recent\nPaperless-ngx 2.x and 3.x, so it is the widest-compatibility default; it\nstays overridab\n[…]\nsted E2E archive serial-number generation for improved test\nstability.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(api): bump default Paperless API version to 9 (fixes #129) (#130)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-07-23T06:36:01Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "78a5748ff6c5bf6a33f1c1c02d8f6f1703299238",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nmpty) and can be confined to allowed directories via the\n`PAPERLESS_MCP_UPLOAD_PATHS` environment variable.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#115)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-07-12T07:07:25Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "bb9d6489d4440240d033d1f875a465c654fae59e",
"body": "## Summary\nReplaces SQLite with PostgreSQL in the e2e test environment to eliminate\nintermittent \"database is locked\" errors that occur when the consumer\nand bulk-edit tasks write concurrently.\n\n## Changes\n- Added PostgreSQL 16 Alpine service to the e2e workflow with health\nchecks\n- Configured Paper\n[…]\natabase health checks and configuration to improve test\nenvironment reliability.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Fix e2e test flakiness by using PostgreSQL instead of SQLite (#126)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-07-12T07:00:19Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9871612fdb8522b909c891f4a8825c8c97ec8313",
"body": "## Summary\nExpose Paperless' richer document query capabilities through MCP so\nagents can filter documents server-side instead of scanning broad result\nsets client-side.\n\n- add `query_documents` as the canonical document query tool\n- keep `list_documents` focused on simple listing\n- keep `search_doc\n[…]\n-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>\nCo-authored-by: Ivo <270578640+sweetrolls115@users.noreply.github.com>\nCo-authored-by: Ivo <270578640+sfk-agent-ivo@users.noreply.github.com>",
"is_bot": false,
"headline": "Add query_documents for advanced document querying (#71)",
"author_name": "Samuel François",
"author_login": "sfkmk",
"committed_at": "2026-07-12T05:55:03Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "5032cec7b1a52d9804b3e3bf956fa3504f09dee0",
"body": "## What\n\nAdds MCP tools for Paperless **document notes**, backed by the\n`/api/documents/{id}/notes/` endpoint:\n\n- `list_document_notes(id)` → `GET /documents/{id}/notes/`\n- `create_document_note(id, note)` → `POST /documents/{id}/notes/`\n- `delete_document_note(id, note_id)` → `DELETE\n/documents/{id\n[…]\nssful operations plus\nvalidation/error behavior.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add document notes tools (create/list/delete) (#125)",
"author_name": "Nick Ponomar",
"author_login": "nickponomar",
"committed_at": "2026-07-10T15:55:21Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "62e5b06ed3b96662501b0ba649ed40cb1b03481c",
"body": "…oding (#119) (#122)\n\n## Summary\n\nFixes #119 — setting a `select` custom field value (via\n`update_document` or `bulk_edit_documents` → `modify_custom_fields`)\nfailed against Paperless. The MCP forwarded the option **label string**,\nwhich Paperless rejects. The server now translates the label to the\n\n[…]\nfor select custom field handling\nacross different Paperless versions.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(documents): translate select custom field labels to Paperless enc…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-06-23T17:58:00Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0d236aa4fe7ed5586d5aeee843e999ca356f8bc7",
"body": "## Overview\n\nStop pre-enumerating Paperless documents in MCP `resources/list` so\nclients no longer receive an unbounded download/thumbnail URI payload at\nstartup. Documents remain available on demand via tools and\n`resources/read` on the `paperless://documents/{id}/{resource}`\ntemplate.\n\n## Context\n\n[…]\n entry documenting the behavior update and version\nbump.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "fix(resources): stop enumerating documents in resources/list (#121)",
"author_name": "Pacman1984",
"author_login": "Pacman1984",
"committed_at": "2026-06-17T15:18:22Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "36e02558b3191fc541bb8fb5e4d7f2f6c5978ef1",
"body": "…uments (#118)\n\n- Added archive_serial_number filter parameter\n- Added archive_serial_number__isnull filter parameter\n- Added custom_field_query filter parameter\n- Added custom_fields__icontains filter parameter\n\nThese filters enable searching documents by:\n- Specific archive serial numbers (ASN)\n- \n[…]\nauto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add archive_serial_number and custom_fields filters to list_doc…",
"author_name": "Klaus Aengenvoort",
"author_login": "klacol",
"committed_at": "2026-06-12T12:41:09Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "6f8aadad9319ce9a89da799bb1cf5dc8ec3cfc96",
"body": "…oads (#116)\n\n## Summary\n\nAdd support for uploading documents directly from the server's\nfilesystem via a new `file_path` parameter on the `post_document` tool,\nas an alternative to the existing base64 `file` parameter.\n\n## Motivation\n\nWhen uploading large files (PDFs, scanned documents), passing th\n[…]\nits.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude Code <noreply@anthropic.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "feat(post_document): add file_path parameter for filesystem-based upl…",
"author_name": "Guillaume Nodet",
"author_login": "gnodet",
"committed_at": "2026-06-12T12:25:43Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "c55da21835b15840117e171254dba49029901a4b",
"body": "## Summary\n- add MCP tools for listing/getting Paperless mail accounts\n- add MCP tools for listing, creating, updating, and deleting Paperless\nmail rules\n- add manual mail-account processing through the Paperless mail account\nprocess endpoint\n- register the new mail tools in the MCP server and cover\n[…]\n\n---------\n\nCo-authored-by: Andreas Hubert <989010+peshay@users.noreply.github.com>\nCo-authored-by: Claude Opus 4.8 <noreply@anthropic.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "[codex] Add Paperless mail rule MCP tools (#111)",
"author_name": "Andreas Hubert",
"author_login": "peshay",
"committed_at": "2026-06-10T03:41:16Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "363b65d8df8c2d61d258109ec33ef64861012413",
"body": "Capture the conventions the maintainer has had to flag by hand in PR\nreview so AI authors and reviewers follow them up front:\n\n- No stray scratch/summary files in commits (e.g. REVIEW_SUMMARY.md)\n- No unsolicited repo-level meta files (e.g. SECURITY.md) unless asked\n- No comments that merely restate\n[…]\nnhanced AI-assisted code review guidance in development instructions.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(ai): encode review guidance into copilot instructions (#117)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-06-03T18:43:16Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "18d49ce1fad9d68d9c6cedc4ea57041325339e32",
"body": "…en in logs (#114)\n\nCloses #113.\n\nAddresses both security issues reported in #113, and realigns the\nper-request token feature (#62 / #61) with its original intent: *not\nleaving the HTTP endpoint open to everyone*.\n\n## Issue 1 — sensitive data in error logs\n\n`PaperlessAPI.request()` logged the raw `o\n[…]\n://claude.ai/code/session_01AMjrdn3bbpMHnL4dqweGv7\n\n---\n_Generated by [Claude\nCode](https://claude.ai/code/session_01AMjrdn3bbpMHnL4dqweGv7)_\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(security): authenticate HTTP mode by default and stop leaking tok…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-06-01T05:49:08Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "72b29a27bae3504d7068bbcbf5d34eed615f79be",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\ncuments, bulk_edit_documents, and post_document — all with\ndeterministic tool calls and no LLM in the loop.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#106)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-05-27T14:43:14Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "22a55f04333f5cb17d1f8f9a4f879ee68ed9391e",
"body": "… #102) (#109)\n\n## Summary\n\nCloses #90. Continuation of #102 (originally by @pipamann), updated for\nthe current `main` and with the three review items addressed.\n\nI'm picking this up from the fork branch per @baruchiro's request on\n#102; the original commits and authorship are preserved.\n\n## What's \n[…]\n review_stack_entry_end -->\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Leon Heuser <leon@dror.de>\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: add MCP resources support for documents (closes #90, supersedes…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-27T13:46:36Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "79f2f0c76e62f7a9ac0a43475e0027550eea07d6",
"body": "## Summary\nAdded support for manual workflow dispatch to the E2E test workflow,\nallowing developers to trigger end-to-end tests on demand without\nwaiting for the scheduled weekly run.\n\n## Changes\n- Added `workflow_dispatch:` trigger to the E2E workflow configuration,\nenabling manual execution via th\n[…]\nn (Mondays at 8 AM UTC) is preserved to\ncontinue catching drift against upstream paperless-ngx.\n\nhttps://claude.ai/code/session_01DxjunYuZbFnY2ZEZpQhWoP\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Enable manual triggering of E2E workflow (#110)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-27T09:24:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9d677b224d3c1a1f8a085100d6b634b437695e2b",
"body": "Closes #101\n\n## Summary\n\n- **`docker-compose.e2e.yml`** — Paperless-ngx 2.14 + Redis fixture\nstack with auto-created admin user\n- **`e2e/e2e.test.ts`** — Deterministic `tools/call` tests (no LLM)\nusing Node's native `node:test` covering all tools from the issue:\n`list_tags`, `create_tag`, `list_corr\n[…]\nium=github&utm_campaign=change_stack)\n\n<!-- review_stack_entry_end -->\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: E2E tests in CI against real Paperless-ngx (#104)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-24T19:21:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "93aa90691dcdadca50fc601089382cf6098d295c",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nad URI, so clients that need the human-readable\n name can still recover it via standard URL parsing.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#103)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-05-24T05:32:47Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ad17c18c3f4450d91c104d22262f3f0a0bcddbe8",
"body": "## Problem\n\n`download_document` and `get_document_thumbnail` return MCP resources\nwith the filename (or an arbitrary string) as the resource URI:\n\n```js\n// download_document\nreturn {\n content: [{\n type: \"resource\",\n resource: {\n uri: filename, // e.g. \"2026-02-15 Vendor Co._Mobile.pdf\"\n \n[…]\nentry_end -->\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Leon Heuser <leon@dror.de>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "fix: use valid URI scheme for document/thumbnail resources (#86)",
"author_name": "pipamann",
"author_login": "pipamann",
"committed_at": "2026-05-20T13:07:16Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "1500d2605cd1a0ac8bf959f2c2205b245171face",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\ns for tags, correspondents, document\ntypes, and custom fields from PUT to PATCH to support partial updates.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#95)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-05-18T06:46:08Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7b483a4677a20155f6fe44505452136232c4e63d",
"body": "…to PATCH (#82)\n\nThis PR extracts only the HTTP method adjustments from PR #70 so the\nchange can be reviewed independently of broader API/tool additions. It\nupdates existing update operations to use partial-update semantics.\n\n- **Scope**\n - Isolates only method-level behavior changes from the large\n[…]\ncopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Extract PR #70 method-only updates: switch update endpoints from PUT …",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-05-18T05:57:56Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "1c1ec60d2e8d5c1c53b30f2d16f44f4bafc2ebb3",
"body": "… (#100)\n\nCloses #91\n\n## Summary\n\n- When `method: \"delete\"`, Paperless's `delete()` action accepts no\nextra kwargs. The MCP wrapper was forwarding `confirm` (and potentially\n`delete_originals`) in the `parameters` object, causing a `400 Bad\nRequest` from Paperless.\n- `confirm` is an MCP-side safety \n[…]\nethod (e.g. `add_tag`) — parameters still\nforwarded correctly\n\n---\n_Generated by [Claude\nCode](https://claude.ai/code/session_018wRYWcNE4fmxKQ4qrSHaFX)_\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: strip MCP-only params from bulk_edit delete request to Paperless…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-18T05:52:13Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "04f29b5ad16d3baee4fa4cbf5d505ad3adfc623a",
"body": "## Summary\n\n- Replaced the Hebrew word `שנה` (\"year\") with its English equivalent\n`\"year\"` in the `bulk_edit_documents` code example in README.md\n\n## Test plan\n\n- [ ] Verify the README example is readable and consistent with the rest\nof the documentation\n\nhttps://claude.ai/code/session_011LGXjipifd2owhUZD1PWW6\n\n---\n_Generated by [Claude\nCode](https://claude.ai/code/session_011LGXjipifd2owhUZD1PWW6)_\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Replace Hebrew text with English in README (#99)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-18T05:48:17Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "59277771b67b58afd0bd2ff557476ea947253ec8",
"body": "## Summary\n\n- Send `modify_custom_fields` bulk edits using Paperless-NGX's expected\n`add_custom_fields` id/value map instead of unsupported\n`assign_custom_fields` fields.\n- Include Paperless-required empty `add_custom_fields` /\n`remove_custom_fields` defaults for `modify_custom_fields` operations.\n-\n[…]\nt.ai -->\n\n---------\n\nCo-authored-by: Andreas Hubert <989010+peshay@users.noreply.github.com>\nCo-authored-by: Scotty <openclaw@ahu.services>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Fix bulk custom field parameters (#89)",
"author_name": "Andreas Hubert",
"author_login": "peshay",
"committed_at": "2026-05-18T05:43:16Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ee6d87a14dda49fd05404f6b56e2bab614b4c11b",
"body": "…PRs (#98)\n\n## Summary\nThis PR adds a new GitHub Actions workflow that automatically marks and\ncloses stale issues and pull requests to help keep the repository clean\nand organized.\n\n## Key Changes\n- Added `.github/workflows/stale.yml` workflow file that:\n - Runs daily at 1:30 AM UTC via scheduled \n[…]\nape hatch via `not-stale` label for items that should\nremain open despite inactivity\n\nhttps://claude.ai/code/session_018q3LCVHiCwEnMxywCd6ZMq\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add GitHub Actions workflow to automatically manage stale issues and …",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-18T05:36:43Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "de661aea7d42e5da8131d5d6c6f8dbaa7cff60ac",
"body": "…age (#97)\n\nReplace the per-request version flip/retry with a single immutable\napiVersion read from PAPERLESS_API_VERSION at construction time (default\n\"5\").\nOn HTTP 406, throw an actionable error message directing users to set\nthe\nenv var. Document the variable in README.\n\nhttps://claude.ai/code/session_01RRup9j9FWH1QRjwG32P8FV\n\nFixes #93\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(api): read API version from env var, surface clear 406 error mess…",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-05-18T05:35:22Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9fb366aa800b1cbd541d3499389d4c2e1ad19900",
"body": null,
"is_bot": false,
"headline": "update REST documentation",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2026-05-17T16:19:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fef4c62b27a09e8aa66f5e70ce61d8472138630c",
"body": "In HTTP/Docker deployments, the single shared `PaperlessAPI` instance\nmeant any client reaching the HTTP port could use the server-configured\ntoken. This adds per-request token support so each client can\nauthenticate with their own Paperless-NGX API token.\n\n## Behaviour\n\n| Scenario | Token used |\n|-\n[…]\neply.github.com>\nCo-authored-by: Cursor Agent <cursoragent@cursor.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>\nCo-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: per-request authentication support in HTTP mode (#62)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-05-17T15:57:17Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "2bdd77927e7070c7dc41643be233d7f7a465f696",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nponses returned by document enhancement, reducing payload size for\n`list_documents` and `search_documents`.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#83)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-05-04T11:27:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "47de91d77e18ba8532f1caa205e959baf328e028",
"body": "…ile preserving pagination shape (#80)\n\n`list_documents` and `search_documents` were forwarding oversized\npaginated responses that included a full `all` ID list, while these\ncalls are intended to return lightweight listing metadata. This change\nkeeps pagination semantics intact (`count`/`next`/`prev\n[…]\nts,\n }),\n }],\n };\n}\n```\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Trim list/search document payloads by removing paginated `all` IDs wh…",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-04-21T04:03:18Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "865803b7c5ae6e48b8e7f9b77e0b58e4fa3caaf8",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nish, and remove the duplicate Docker build from CI. Add\n`workflow_dispatch` to the Docker publish workflow.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#79)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-04-20T18:48:37Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "76c7d8bfd8e176dc657327ee0da5901b7c9a97af",
"body": "The compiled entrypoint uses `require(\"../package.json\")` from\n`build/index.js`, so production must keep `/app/build/index.js` with\n`/app/package.json` as its parent directory.\n\nPreviously the image copied `build/*` into `/app`, which broke\nresolution of `../package.json` at runtime (see\nhttps://git\n[…]\nication dependencies at runtime.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "fix: Docker image preserves build/ layout for CLI (#78)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-04-20T18:46:49Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "7981f6b31ab47e1117f9db6a53cd67e0a63da740",
"body": "Adds a parallel `docker-smoke` job (build image, run with dummy\nPaperless env, assert GET /mcp returns 405) and `workflow_dispatch` so\nCI can be run manually.\n\nDockerfile layout fix is intentionally **not** included; it will ship in\na follow-up PR so this change can land and validate against current\n[…]\n readiness by checking service endpoints.\n* Enhanced cleanup procedures to ensure containers are properly removed\nafter testing.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
"is_bot": false,
"headline": "ci: Docker smoke job and manual workflow dispatch (#77)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-04-20T18:40:38Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0ae1dec1d38feb63c8e9f40c376d9d86fb4b490b",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nx CLI binary regression by restoring build/index.js as the\nexecutable entrypoint for the published package.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#74)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-04-20T17:40:08Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "47fdf281da66df1579a30623d546bd9614c183b4",
"body": "`@baruchiro/paperless-mcp@0.4.2` regressed CLI startup: `npx` could not\nresolve `paperless-mcp` even though `bin` pointed to `build/index.js`.\nThe published artifact layout changed so the executable path no longer\nexisted.\n\n- **Root cause**\n- `src/index.ts` switched to a JSON module import for `pack\n[…]\ne CLI entrypoint regression fix.\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Restore npm CLI entrypoint for `paperless-mcp` package (#73)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-04-19T09:21:37Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9f3e74f412b53f17fba5c1cfeb6b7800880cfff0",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nhe\nPaperless-NGX API.\n- b950817: Read server version dynamically from package.json instead of\nhardcoding it\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#65)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-04-15T10:31:30Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "606fc45160b315440ad4ed36f77b159885033ec1",
"body": "…ore API call (#69)\n\n`bulk_edit_documents` with `method: \"delete\"` always returned HTTP 400\nbecause `confirm` (a client-side safety gate) was being forwarded to the\nPaperless-NGX `/api/documents/bulk_edit/` endpoint, which doesn't accept\nit.\n\n## Changes\n\n- **`src/tools/documents.ts`**: Destructure `\n[…]\nng your project management tool.\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Fix bulk_edit_documents delete: strip client-side `confirm` param bef…",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-03-15T06:17:47Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b950817382b632e0acf7739d1968da4086e3a4bb",
"body": "The `McpServer` instantiation had a hardcoded `version: \"1.0.0\"` that\nwas perpetually out of sync with the actual package version.\n\n### Changes\n\n- **`tsconfig.json`** — Enable `resolveJsonModule: true` to allow typed\nJSON imports\n- **`src/index.ts`** — Import `version` from `package.json` and pass i\n[…]\n work when set up for\nyour repo.\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Read server version from package.json instead of hardcoding it (#64)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-03-01T11:16:35Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5ad68b6b3ea80c7f5701968a177e74352645c7a4",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\n\n@baruchiro/paperless-mcp) with actionable error messages suggesting the\ncorrect format (e.g., `USD10.00`).\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#58)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-02-24T07:20:48Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "77d77e9ea42db9663f0e2f46168a0a5e53e43613",
"body": "…ing-symbol mistakes early (#57)\n\n- [x] Explore repo structure and understand the codebase\n- [x] Create `src/tools/utils/monetary.ts` – validation utility for\nmonetary custom field values\n- [x] Update `update_document` and `bulk_edit_documents` tools with\nimproved descriptions and validation\n- [x] U\n[…]\ncopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Fix monetary custom field UX: clarify currency format and catch trail…",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-02-24T07:19:47Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9783e4c06f02dc8a74822cb2e321886fa600ba54",
"body": "### Summary\n\n- Fixed `post_document` action failing in Node.js environments by\nreplacing the browser `File` API with `Buffer` for `FormData` file\nuploads\n- Ensured metadata fields are properly stringified before appending to\n`FormData`\n\n### Details\nThe `post_document` tool was using `new File()` whi\n[…]\nnterface.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Claude <noreply@anthropic.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Fix post_document: use Buffer instead of browser File API (#55)",
"author_name": "Philipp Soldunov",
"author_login": "psoldunov",
"committed_at": "2026-02-22T16:29:34Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9e9199f63f66011f7131504bba09a403d849caca",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\ntation\n- 8953487: Remove Smithery documentation and badge as the service no\nlonger supports this MCP server\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#50)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-02-13T09:55:10Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9972ac7e61650e33b2fff6a7b2c150288a9595cb",
"body": "Adds support for retrieving document thumbnail previews from\nPaperless-NGX's `/api/documents/{id}/thumb/` endpoint.\n\n## Changes\n\n- **API Client** (`PaperlessAPI.ts`): Added `getThumbnail(id)` method\nusing axios with `responseType: \"arraybuffer\"` to fetch WebP thumbnails\n- **MCP Tool** (`documents.ts\n[…]\nlease notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Add get_document_thumbnail tool for retrieving document previews (#53)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-02-13T09:54:25Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "e2ac0f62c557842ce5334e631b5624a6adbd5cbc",
"body": "…ation (#46)\n\n## Documentation Enhancement Plan\n\n- [x] Review the current README structure and Docker documentation\n- [x] Add a new \"Docker Deployment\" section after the \"Running the MCP\nServer\" section\n- [x] Include the Docker Compose configuration provided by the user\n- [x] Add Continue VS Code ex\n[…]\ncopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Add Docker Compose and Continue VS Code extension deployment document…",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-28T04:30:08Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8953487389286ffaf3e7f4ef41befe801fee7027",
"body": "The Smithery badge and installation instructions were linking to a 404.\nSmithery no longer supports this MCP server distribution model.\n\n**Changes:**\n- Removed Smithery badge from README header\n- Removed \"Installing via Smithery\" section from README\n- Deleted `smithery.yaml` configuration file\n- Cre\n[…]\n.</sup>\n<!-- /CURSOR_SUMMARY -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Remove Smithery documentation and badge (#49)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-20T10:08:41Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "a271005263e1df998774c1329ccb2de59aa272f2",
"body": null,
"is_bot": false,
"headline": "npm support OIDC",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2026-01-20T06:47:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6b52829d2651e68255e02ad1863a2118ff273843",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nved\nperformance and security. Updated Dockerfile, package.json engines\nfield, and added .node-version file.\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#44)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2026-01-20T06:40:01Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0580b09d942c5cf2b608b72be6a21fff6a6685cd",
"body": "…lishing",
"is_bot": false,
"headline": "Add GITHUB_TOKEN environment variable to release workflow for npm pub…",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2026-01-20T06:38:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "80740ee48fd76efafc2c2cf0d8d1f8a1f9edd23e",
"body": null,
"is_bot": false,
"headline": "fix release",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2026-01-20T06:36:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "835b514a7ba0724f20529d9323228e72c272a882",
"body": "<!-- This is an auto-generated comment: release notes by coderabbit.ai\n-->\n## Summary by CodeRabbit\n\n* **Chores**\n * Bumped Node.js used in the release pipeline to v24.\n * Upgraded release pipeline tooling.\n * Strengthened CI workflow permissions and security.\n* Migrated publish/authentication fl\n[…]\n60c95e8f924. This will update automatically\non new commits. Configure\n[here](https://cursor.com/dashboard?tab=bugbot).</sup>\n<!-- /CURSOR_SUMMARY -->\n\nCo-authored-by: Baruch Odem <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Use trusted publisher for npm (#37)",
"author_name": "Orgad Shaneh",
"author_login": "orgads",
"committed_at": "2026-01-20T06:34:04Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f1f62e1a842f025cbb4813c9a45f24e0f70b4a12",
"body": "- Added a new `.node-version` file specifying Node.js version 24.\n- Updated Dockerfile to use Node.js 24 for both builder and production\nstages.\n- Updated `package.json` and `package-lock.json` to require\n`@types/node` version 24 and set the Node.js engine requirement to\n`>=24.0.0`.\n\n<!-- CURSOR_SUM\n[…]\nigh-level summary in your review\nsettings.</sub>\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update Node.js version to 24 in Dockerfile and package files (#47)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2026-01-20T06:30:31Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f9291df1c2871f7b8aa7a2a90fd28f9fdf211804",
"body": "…usage (#45)\n\n## Implementation Complete ✅\n\n**Simplified approach per feedback:**\n- [x] Remove code comments\n- [x] Remove `fields` parameter complexity (no FieldFilterOptions, no\nfield filtering logic)\n- [x] Simply exclude `content` from all document responses by default\n- [x] Add new `get_document_\n[…]\n.</sup>\n<!-- /CURSOR_SUMMARY -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Exclude document content field by default to optimize context window …",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-20T04:42:06Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "61d5609d736d0ef9672e72f955e90b78c665cf12",
"body": "## Fix documentlink custom field validation to accept arrays\n\n### Problem\nThe MCP server cannot modify custom fields when they're \"documentlink\"\ntypes. The Zod validation schema restricts custom field values to only\n`string | number | boolean | null`, which excludes arrays needed for\ndocumentlink fi\n[…]\ncopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Fix documentlink custom field validation to accept arrays (#39)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-18T06:34:43Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "537b55750c15fd38a9d148e0d4d8916dacd20ac3",
"body": "Removes the OpenHands automated issue resolver integration from the\nrepository.\n\n## Changes\n- Deleted `.github/workflows/openhands-resolver.yml` workflow file\n\nThe workflow previously triggered on issue/PR labels, comments, and\nreviews to automatically invoke the OpenHands resolver.\n\n<!-- START COPI\n[…]\n.</sup>\n<!-- /CURSOR_SUMMARY -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Remove OpenHands integration (#43)",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-18T06:13:48Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "6eda6e308243beaa79ecfe30fd13afad8574bee4",
"body": "…ure (#41)\n\n## Setup Copilot Instructions for paperless-mcp\n\nBased on GitHub Copilot best practices, created comprehensive Copilot\ninstructions:\n\n- [x] Create `.github/copilot-instructions.md` with repository-wide\nguidelines\n - [x] Define project structure and overview\n - [x] Document build, test,\n[…]\n.</sup>\n<!-- /CURSOR_SUMMARY -->\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: baruchiro <17686879+baruchiro@users.noreply.github.com>",
"is_bot": false,
"headline": "Add GitHub Copilot instructions for repository conventions and struct…",
"author_name": "Copilot",
"author_login": "Copilot",
"committed_at": "2026-01-18T06:13:19Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9b49540131c421dd19510b9824b415a967eef2e6",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\n Releases\n## @baruchiro/paperless-mcp@0.2.3\n\n### Patch Changes\n\n- 5a5d6d2: Docker: Add arm64 architecture\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#36)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-12-30T07:30:09Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "5a5d6d251434ce7092ea121a791ecff8aa973077",
"body": "Disclaimer: I don't have the package registry set up, so I couldn't\nverify the full publish workflow.\n\nThe check is failing for the same reason:\n```\nERROR: failed to push ghcr.io/baruchiro/paperless-mcp:pr-33: denied: installation not allowed to Write organization package\n```\n\n<!-- CURSOR_SUMMARY --\n[…]\ne this high-level summary in your review\nsettings.</sub>\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Docker: Add arm64 architecture (#33)",
"author_name": "Nick Christensen",
"author_login": "NickChristensen",
"committed_at": "2025-12-30T07:29:34Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f41ef6e2cb849ad4ce073cbb8be94d5cfd2e1d44",
"body": "<!-- CURSOR_SUMMARY -->\n> [!NOTE]\n> Improves Docker publish workflow to avoid failures on forked PRs.\n> \n> - Adds `check-fork` step to detect if a PR originates from a fork and\nset `is_fork`\n> - Gates `docker/login-action` and `docker/build-push-action` `push`\nflag on `is_fork == 'false'`\n> - Retain\n[…]\nab=bugbot) for commit\n6d6d43fabc1d79aa5acc4be0b624c9c26ca3f21a. This will update automatically\non new commits. Configure\n[here](https://cursor.com/dashboard?tab=bugbot).</sup>\n<!-- /CURSOR_SUMMARY -->",
"is_bot": false,
"headline": "do not fail on docker push on fork (#35)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-12-30T07:26:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "bfc1eee70943a7c2b6c393282ee7ec8c9f530d09",
"body": "This reverts commit f6ab1e5eed5729c9040bba6badbbb0f0e63bf07d.",
"is_bot": false,
"headline": "Revert \"allow forks to publish docker (#34)\"",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-12-30T07:22:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f6ab1e5eed5729c9040bba6badbbb0f0e63bf07d",
"body": "<!-- CURSOR_SUMMARY -->\n> [!NOTE]\n> **CI workflow change**\n> \n> - In `./.github/workflows/docker-publish.yml`, update GHCR login to\nuse `username: ${{ github.repository_owner }}` and `password: ${{\nsecrets.GHCR_PAT }}` instead of `github.actor`/`GITHUB_TOKEN` to allow\nDocker image publishing from fo\n[…]\nab=bugbot) for commit\nb73bd02075c42a45e4745e535ee438e8e923283f. This will update automatically\non new commits. Configure\n[here](https://cursor.com/dashboard?tab=bugbot).</sup>\n<!-- /CURSOR_SUMMARY -->",
"is_bot": false,
"headline": "allow forks to publish docker (#34)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-12-30T07:19:23Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ace151f364e666daeb7d5ce66ee2ec8af87ffae6",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\n.\n\n\n# Releases\n## @baruchiro/paperless-mcp@0.2.2\n\n### Patch Changes\n\n- ff27606: add descriptions to tools\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#32)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-11-25T19:43:18Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ff2760624ba077414912400ac64655b92c22ba39",
"body": "shuts up the \"The following tools are out of spec... tool schema\ncontains empty description\" warnings in some clients\n\n<!-- This is an auto-generated comment: release notes by coderabbit.ai\n-->\n## Summary by CodeRabbit\n\n* **Documentation**\n* Added and expanded descriptive help text for tools across\n\n[…]\nttps://cursor.com/dashboard?tab=bugbot).</sup>\n<!-- /CURSOR_SUMMARY -->\n\n---------\n\nCo-authored-by: robertlestak <robert.lestak@umusic.com>\nCo-authored-by: Baruch Odem (Rothkoff) <baruchiro@gmail.com>",
"is_bot": false,
"headline": "add descriptions to tools (#31)",
"author_name": "robert lestak",
"author_login": "robertlestak",
"committed_at": "2025-11-25T19:42:24Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "98f4f804d23f3f7942243fa79c8045a9749e67e1",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\neleases\n## @baruchiro/paperless-mcp@0.2.1\n\n### Patch Changes\n\n- 270a695: bump to fix the release pipeline\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#30)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-11-11T18:35:07Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "270a69515b57b4a726a428ce461062bd033a8208",
"body": null,
"is_bot": false,
"headline": "bump to fix the release pipeline",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-11-11T18:33:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "289590e2055fbf27626344c211e13634043a3877",
"body": "<!-- CURSOR_SUMMARY -->\n> [!NOTE]\n> Adds a GitHub Actions workflow that invokes the OpenHands resolver on\nlabeled issues/PRs and new comments/reviews, configured via repo vars\nand secrets.\n> \n> - **CI**:\n> - **New workflow** `/.github/workflows/openhands-resolver.yml`:\n> - Triggers on `issues` and\n[…]\nhat\nstreamlines handling of labeled issues and review activities, enabling\nfaster issue management through AI-driven automation.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
"is_bot": false,
"headline": "try openhands resolver (#29)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-11-11T18:01:05Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "26b50e1103bf5ccdaab72d7c319f366592220cab",
"body": null,
"is_bot": false,
"headline": "Added CodeRabbit Pull Request Reviews badge to README",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-09-30T17:46:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d988a130fd6fb9b849ede5ed5db0759916195044",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nrect format and number range for matching_algoritm\nparameter\n\n### Patch Changes\n\n- 7c89701: improve types\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#23)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-08-13T08:22:49Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7c897012cc032aeb7d1a7f4d9afb9d2c8e50f8a0",
"body": "- **Add BasicUser and Note interfaces to types.ts**\n- **Refactor registerCorrespondentTools to use api.updateCorrespondent\nfor updating correspondent data**\n- **Update document type API calls to use dedicated methods for updating\nand deleting document types**\n- **Enhance getCorrespondents and getCor\n[…]\nhores\n - Patch release prepared to deliver type improvements.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Ramon Nieves <ramon.ackermann@sboo.eu>",
"is_bot": false,
"headline": "Improve Types (#22)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-08-13T08:22:13Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "63b31c119c8fd35468f2e9b2afe1abb63ae1bba4",
"body": "Matching algorithm is an integer between 0 and 6:\n\n 0 - None\n 1 - Any word\n 2 - All words\n 3 - Exact match\n 4 - Regular expression\n 5 - Fuzzy word\n 6 - Automatic\n\nI fixed this in code as well as Readme\n\n<!-- This is an auto-generated comment: release notes by coderabbit.ai\n-->\n## Summary by Co\n[…]\ndata (owner,\nuser_can_change) and clearer permissions/notes shapes.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Baruch Odem <baruchiro@gmail.com>",
"is_bot": false,
"headline": "fix(matching_algorithm): Use correct format and number range (#21)",
"author_name": "Sboo!",
"author_login": "sboo",
"committed_at": "2025-08-13T07:22:22Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f9bbf7567f247bc41e19cfdf3790f148e39421ca",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\n date filtering logic to ensure accurate\nresults\n- 17990fb: Add packaged Desktop Extension file, manifest\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#20)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-08-10T06:19:06Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "17990fb9299fe964a0b2ce6dc11a00de47612583",
"body": "See the following for for more context around Desktop Extensions, but\nthe tl;dr is much easier installation for end-users.\n- [Claude Desktop Extensions: One-click MCP server installation for\nClaude\nDesktop](https://www.anthropic.com/engineering/desktop-extensions)\n- [dxt/README.md at main ·\nanthropi\n[…]\nemoved redundant server logging output for cleaner console display.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\n---------\n\nCo-authored-by: Baruch Odem <baruchiro@gmail.com>",
"is_bot": false,
"headline": "Add packaged Desktop Extension file, manifest (#14)",
"author_name": "Nick Christensen",
"author_login": "NickChristensen",
"committed_at": "2025-08-10T06:18:10Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "42c94bdf8574a16dce94ce858d494a61db874c2c",
"body": "…(#19)\n\nFix #18\n\n<!-- This is an auto-generated comment: release notes by coderabbit.ai\n-->\n## Summary by CodeRabbit\n\n* **Bug Fixes**\n* Corrected date filtering logic to ensure accurate results when listing\ndocuments by creation date.\n* **New Features**\n* Updated query parameter names for filtering documents by creation date\nfor improved clarity.\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
"is_bot": false,
"headline": "fix(filter): correct date filtering logic to ensure accurate results …",
"author_name": "aKzenT",
"author_login": "aKzenT",
"committed_at": "2025-08-08T13:38:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "27583ae6cc6989f70234971d3b49c5cbca7845ce",
"body": "This PR refactors error handling across all tool registration functions\nand adds comprehensive custom field operations to the Paperless-NGX MCP\nServer.\n\nFix #16\n\n### Changes Made\n\n#### Error Handling Refactor\n- Replaced `errorMiddleware` with `withErrorHandling` in all tool\nregistration functions fo\n[…]\n API validation/type safety guidelines.\n\n* **Chores**\n* Refactored middleware and utility functions for consistency and\nclarity.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
"is_bot": false,
"headline": "custom field operations (#17)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-08-07T17:30:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3536453fef129233e3b7102219110e4bc62bb11f",
"body": null,
"is_bot": false,
"headline": "Update Docker image metadata action to use repository name only",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-08-07T17:29:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "921d14badaf774b2f954493c3b4ca4a1b62335cc",
"body": "The Docker publishing workflow was previously tagging images built from\nthe main branch with the branch name itself (e.g., 'main') instead of\nthe standard 'latest' tag.\n\nThis commit modifies the .github/workflows/docker-publish.yml file to:\n- Correctly apply the 'latest' tag to images built from the\n[…]\nases and main branch builds.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->\n\nCo-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>",
"is_bot": false,
"headline": "Fix: Ensure main branch Docker image is tagged as latest (#10)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-08-07T16:47:39Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "70698f641ffb504dd460d511f19e07a19ef78d17",
"body": null,
"is_bot": false,
"headline": "0.0.3",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-07-30T15:10:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9d1e9b01f58f4222434f78a2b633e9b0471301ba",
"body": null,
"is_bot": false,
"headline": "Update README and index.ts to include PAPERLESS_PUBLIC_URL configuration",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-07-30T15:02:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e7f93cf98a86457296beafb035a54a0409d2cd8e",
"body": null,
"is_bot": false,
"headline": "Merge remote-tracking branch 'upstream/main' into merge",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-07-30T14:34:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "11fd1c6da313fefc94e1b11882365b5109854109",
"body": "Add HTTP Transport Mode, Docker Support, and Migrate to Official MCP SDK",
"is_bot": false,
"headline": "Merge pull request #4 from baruchiro/official-mcp",
"author_name": "Nick Loui",
"author_login": "nloui",
"committed_at": "2025-07-20T17:39:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1a322414ed2f3354df46eb47860280ab91882acc",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' into official-mcp",
"author_name": "Nick Loui",
"author_login": "nloui",
"committed_at": "2025-07-20T17:39:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5d7b3a4b74759806b5ce3f9eeeba3f42d3719e67",
"body": "Deployment: Dockerfile and Smithery config",
"is_bot": false,
"headline": "Merge pull request #2 from smithery-ai/smithery/config-43he",
"author_name": "Nick Loui",
"author_login": "nloui",
"committed_at": "2025-07-20T17:38:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f775b02256b3be90b3df93d6c631373af5223ffc",
"body": "Add MseeP.ai badge",
"is_bot": false,
"headline": "Merge pull request #7 from lwsinclair/add-mseep-badge-74065bf9",
"author_name": "Nick Loui",
"author_login": "nloui",
"committed_at": "2025-07-20T17:37:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c534351e18d2f0a75de26d04bb82956ecfe8d2f2",
"body": null,
"is_bot": false,
"headline": "Add MseeP.ai badge to README.md",
"author_name": "Lawrence Sinclair",
"author_login": "lwsinclair",
"committed_at": "2025-07-17T09:25:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "61da732421718598b9cad94675aafb746f00bcc5",
"body": null,
"is_bot": false,
"headline": "Add install badge to README.md (#12)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-06-05T05:46:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0ef3b2c898d1f72fbccb4b024392bd98aed54a22",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\nases\n## @baruchiro/paperless-mcp@0.0.2\n\n### Patch Changes\n\n- 74b9cc1: change API_KEY to PAPERLESS_API_KEY\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#8)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-05-20T16:30:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "74b9cc19cf8dd0c5bcfa70e198e17b9596935e1e",
"body": null,
"is_bot": false,
"headline": "change API_KEY to PAPERLESS_API_KEY",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-20T16:29:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b2ef8ed148b69768149f61493b05245f8a00b7ca",
"body": "This PR was opened by the [Changesets\nrelease](https://github.com/changesets/action) GitHub action. When\nyou're ready to do a release, you can merge this and the packages will\nbe published to npm automatically. If you're not ready to do a release\nyet, that's fine, whenever you add more changesets to\n[…]\n# @baruchiro/paperless-mcp@0.0.1\n\n### Patch Changes\n\n- b3ad43d: adjust entry point, and arguments or envs\n\nCo-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "Version Packages (#6)",
"author_name": "github-actions[bot]",
"author_login": "github-actions[bot]",
"committed_at": "2025-05-20T05:22:12Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "666572636772bf6608736aa3da4e578e79191549",
"body": "…s and pull-requests",
"is_bot": false,
"headline": "Update release workflow permissions to allow write access for content…",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-20T05:21:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b3ad43d1358bb1c0ede5f1592cf7f15ff3b7c7b2",
"body": null,
"is_bot": false,
"headline": "adjust entry point, and arguments or envs (#5)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-05-20T05:18:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ac1d7b427a7c06706ed1f0c7a5802bbb71e89e0c",
"body": "…d Docker usage",
"is_bot": false,
"headline": "Update README.md to reflect changes in MCP configuration for local an…",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-20T04:32:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "340083ec2f4e67273a08f41a152a094c1cea0923",
"body": "This PR adds files for deploying your MCP server on Smithery. After\ndeployment, users can use your server over streamable HTTP (hosted on\n[Smithery](https://smithery.ai)) without needing to install any\ndependencies.\n\n### Changes\n- Added **Dockerfile** to package your server for deployment.\n- Added *\n[…]\nere automatically generated and tested by Smithery*\n\n---------\n\nCo-authored-by: smithery-ai[bot] <194235850+smithery-ai[bot]@users.noreply.github.com>\nCo-authored-by: Baruch Odem <baruchiro@gmail.com>",
"is_bot": true,
"headline": "Deployment: Dockerfile and Smithery config (#4)",
"author_name": "smithery-ai[bot]",
"author_login": "smithery[bot]",
"committed_at": "2025-05-19T06:12:44Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7cb8ae42b4abc1b5e1c4d2b02a24966fcb9aa10a",
"body": null,
"is_bot": false,
"headline": "Add permissions for contents and id-token in release workflow",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:55:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a0adeca452babbfc1ffbb9fe3297d2fcc077aa87",
"body": null,
"is_bot": false,
"headline": "Add registry URL for npm in release workflow",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:53:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c405d868f07a3a3e822db091037afc524ea843f2",
"body": "…and in release workflow",
"is_bot": false,
"headline": "Update package.json repository URL format and adjust npm publish comm…",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:50:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a1b7e933516950e4a111162ad9049b31d7cf9ebe",
"body": "- **Add Changesets configuration and update devDependencies in\npackage.json**\n- **Update Docker publish and release workflows to support version\ntagging and conditional execution**",
"is_bot": false,
"headline": "changeset (#3)",
"author_name": "Baruch Odem (Rothkoff)",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:42:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2cd218bbdf2861d1943aac0e1c2807ce522df687",
"body": null,
"is_bot": false,
"headline": "prepublishonly",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:40:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8bdce669d49b9cc199f59c23df93ff3d1dd1f0e",
"body": "…ackage.json; enable declaration output in tsconfig.json; modify release workflow to include npm publish",
"is_bot": false,
"headline": "Update package version, main entry point, and add prepare script in p…",
"author_name": "Baruch Odem",
"author_login": "baruchiro",
"committed_at": "2025-05-18T14:35:50Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 0,
"commits_last_year": 78,
"latest_release_at": null,
"latest_release_tag": null,
"releases_from_tags": false,
"days_since_last_push": 9,
"active_weeks_last_year": 24,
"days_since_latest_release": null,
"mean_days_between_releases": null
},
"community": {
"has_readme": false,
"has_license": false,
"has_description": false,
"has_contributing": false,
"health_percentage": null,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "@baruchiro/paperless-mcp",
"exists": true,
"license": "ISC",
"keywords": [
"mcp",
"paperless-ngx",
"document-management",
"ai",
"claude",
"model-context-protocol",
"paperless"
],
"ecosystem": "npm",
"matches_repo": true,
"registry_url": "https://www.npmjs.com/package/@baruchiro/paperless-mcp",
"is_deprecated": false,
"latest_version": "2.0.1",
"repository_url": "https://github.com/baruchiro/paperless-mcp",
"versions_count": 21,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": 1,
"monthly_downloads": 2428,
"first_published_at": "2025-05-18T14:21:43.965000Z",
"latest_published_at": "2026-07-23T06:48:12.214000Z",
"latest_version_yanked": null,
"days_since_latest_publish": 9
}
]
},
"popularity": {
"forks": 33,
"stars": 135,
"watchers": 3,
"fork_history": {
"days": [
{
"date": "2025-07-07",
"count": 1
},
{
"date": "2025-07-19",
"count": 1
},
{
"date": "2025-07-20",
"count": 1
},
{
"date": "2025-08-02",
"count": 1
},
{
"date": "2025-08-27",
"count": 1
},
{
"date": "2025-10-12",
"count": 1
},
{
"date": "2025-10-15",
"count": 1
},
{
"date": "2025-10-18",
"count": 1
},
{
"date": "2026-01-07",
"count": 1
},
{
"date": "2026-02-20",
"count": 1
},
{
"date": "2026-03-05",
"count": 1
},
{
"date": "2026-03-06",
"count": 1
},
{
"date": "2026-03-17",
"count": 1
},
{
"date": "2026-04-04",
"count": 1
},
{
"date": "2026-04-13",
"count": 1
},
{
"date": "2026-04-15",
"count": 1
},
{
"date": "2026-04-18",
"count": 1
},
{
"date": "2026-04-23",
"count": 1
},
{
"date": "2026-04-26",
"count": 1
},
{
"date": "2026-04-28",
"count": 1
},
{
"date": "2026-04-30",
"count": 1
},
{
"date": "2026-05-08",
"count": 1
},
{
"date": "2026-05-14",
"count": 1
},
{
"date": "2026-05-17",
"count": 1
},
{
"date": "2026-05-24",
"count": 1
},
{
"date": "2026-05-25",
"count": 1
},
{
"date": "2026-06-03",
"count": 3
},
{
"date": "2026-06-07",
"count": 1
},
{
"date": "2026-07-08",
"count": 1
},
{
"date": "2026-07-12",
"count": 1
},
{
"date": "2026-07-25",
"count": 1
}
],
"complete": true,
"collected": 33,
"total_forks": 33
},
"star_history": null,
"open_issues_and_prs": 6
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": true,
"has_mcp_signal": true,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"tsconfig.json"
],
"toolchain_manifests": [],
"largest_source_bytes": 37202,
"source_files_sampled": 34,
"oversized_source_files": 0,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 19079
},
"dependencies": {
"manifests": [
"package.json"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 109,
"malicious_count": 0,
"assessed_package": "npm:@baruchiro/paperless-mcp@2.0.1",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"npm"
],
"dependencies": [
{
"name": "@modelcontextprotocol/sdk",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^1.11.1"
},
{
"name": "axios",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^1.9.0"
},
{
"name": "express",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^5.1.0"
},
{
"name": "form-data",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^4.0.2"
},
{
"name": "typescript",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^5.8.3"
},
{
"name": "zod",
"manifest": "package.json",
"ecosystem": "npm",
"version_constraint": "^3.24.1"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "@modelcontextprotocol/sdk",
"direct": true,
"version": "1.11.1",
"ecosystem": "npm"
},
{
"name": "axios",
"direct": true,
"version": "1.9.0",
"ecosystem": "npm"
},
{
"name": "express",
"direct": true,
"version": "5.1.0",
"ecosystem": "npm"
},
{
"name": "form-data",
"direct": true,
"version": "4.0.2",
"ecosystem": "npm"
},
{
"name": "typescript",
"direct": true,
"version": "5.8.3",
"ecosystem": "npm"
},
{
"name": "zod",
"direct": true,
"version": "3.25.76",
"ecosystem": "npm"
},
{
"name": "@anthropic-ai/dxt",
"direct": false,
"version": "0.2.6",
"ecosystem": "npm"
},
{
"name": "@babel/runtime",
"direct": false,
"version": "7.27.1",
"ecosystem": "npm"
},
{
"name": "@changesets/apply-release-plan",
"direct": false,
"version": "7.0.12",
"ecosystem": "npm"
},
{
"name": "@changesets/assemble-release-plan",
"direct": false,
"version": "6.0.8",
"ecosystem": "npm"
},
{
"name": "@changesets/changelog-git",
"direct": false,
"version": "0.2.1",
"ecosystem": "npm"
},
{
"name": "@changesets/cli",
"direct": false,
"version": "2.29.4",
"ecosystem": "npm"
},
{
"name": "@changesets/config",
"direct": false,
"version": "3.1.1",
"ecosystem": "npm"
},
{
"name": "@changesets/errors",
"direct": false,
"version": "0.2.0",
"ecosystem": "npm"
},
{
"name": "@changesets/get-dependents-graph",
"direct": false,
"version": "2.1.3",
"ecosystem": "npm"
},
{
"name": "@changesets/get-release-plan",
"direct": false,
"version": "4.0.12",
"ecosystem": "npm"
},
{
"name": "@changesets/get-version-range-type",
"direct": false,
"version": "0.4.0",
"ecosystem": "npm"
},
{
"name": "@changesets/git",
"direct": false,
"version": "3.0.4",
"ecosystem": "npm"
},
{
"name": "@changesets/logger",
"direct": false,
"version": "0.1.1",
"ecosystem": "npm"
},
{
"name": "@changesets/parse",
"direct": false,
"version": "0.4.1",
"ecosystem": "npm"
},
{
"name": "@changesets/pre",
"direct": false,
"version": "2.0.2",
"ecosystem": "npm"
},
{
"name": "@changesets/read",
"direct": false,
"version": "0.6.5",
"ecosystem": "npm"
},
{
"name": "@changesets/should-skip-package",
"direct": false,
"version": "0.1.2",
"ecosystem": "npm"
},
{
"name": "@changesets/types",
"direct": false,
"version": "4.1.0",
"ecosystem": "npm"
},
{
"name": "@changesets/types",
"direct": false,
"version": "6.1.0",
"ecosystem": "npm"
},
{
"name": "@changesets/write",
"direct": false,
"version": "0.4.0",
"ecosystem": "npm"
},
{
"name": "@cspotcode/source-map-support",
"direct": false,
"version": "0.8.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/checkbox",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/confirm",
"direct": false,
"version": "4.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/core",
"direct": false,
"version": "9.2.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/editor",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/expand",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/figures",
"direct": false,
"version": "1.0.13",
"ecosystem": "npm"
},
{
"name": "@inquirer/input",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/number",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/password",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/prompts",
"direct": false,
"version": "6.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/rawlist",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/search",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/select",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "@inquirer/type",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "@jridgewell/resolve-uri",
"direct": false,
"version": "3.1.2",
"ecosystem": "npm"
},
{
"name": "@jridgewell/sourcemap-codec",
"direct": false,
"version": "1.5.0",
"ecosystem": "npm"
},
{
"name": "@jridgewell/trace-mapping",
"direct": false,
"version": "0.3.9",
"ecosystem": "npm"
},
{
"name": "@manypkg/find-root",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "@manypkg/get-packages",
"direct": false,
"version": "1.1.3",
"ecosystem": "npm"
},
{
"name": "@nodelib/fs.scandir",
"direct": false,
"version": "2.1.5",
"ecosystem": "npm"
},
{
"name": "@nodelib/fs.stat",
"direct": false,
"version": "2.0.5",
"ecosystem": "npm"
},
{
"name": "@nodelib/fs.walk",
"direct": false,
"version": "1.2.8",
"ecosystem": "npm"
},
{
"name": "@tsconfig/node10",
"direct": false,
"version": "1.0.11",
"ecosystem": "npm"
},
{
"name": "@tsconfig/node12",
"direct": false,
"version": "1.0.11",
"ecosystem": "npm"
},
{
"name": "@tsconfig/node14",
"direct": false,
"version": "1.0.3",
"ecosystem": "npm"
},
{
"name": "@tsconfig/node16",
"direct": false,
"version": "1.0.4",
"ecosystem": "npm"
},
{
"name": "@types/body-parser",
"direct": false,
"version": "1.19.5",
"ecosystem": "npm"
},
{
"name": "@types/connect",
"direct": false,
"version": "3.4.38",
"ecosystem": "npm"
},
{
"name": "@types/express",
"direct": false,
"version": "5.0.2",
"ecosystem": "npm"
},
{
"name": "@types/express-serve-static-core",
"direct": false,
"version": "5.0.6",
"ecosystem": "npm"
},
{
"name": "@types/http-errors",
"direct": false,
"version": "2.0.4",
"ecosystem": "npm"
},
{
"name": "@types/mime",
"direct": false,
"version": "1.3.5",
"ecosystem": "npm"
},
{
"name": "@types/mute-stream",
"direct": false,
"version": "0.0.4",
"ecosystem": "npm"
},
{
"name": "@types/node",
"direct": false,
"version": "12.20.55",
"ecosystem": "npm"
},
{
"name": "@types/node",
"direct": false,
"version": "22.19.7",
"ecosystem": "npm"
},
{
"name": "@types/node",
"direct": false,
"version": "24.10.9",
"ecosystem": "npm"
},
{
"name": "@types/qs",
"direct": false,
"version": "6.14.0",
"ecosystem": "npm"
},
{
"name": "@types/range-parser",
"direct": false,
"version": "1.2.7",
"ecosystem": "npm"
},
{
"name": "@types/send",
"direct": false,
"version": "0.17.4",
"ecosystem": "npm"
},
{
"name": "@types/serve-static",
"direct": false,
"version": "1.15.7",
"ecosystem": "npm"
},
{
"name": "@types/wrap-ansi",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "accepts",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "acorn",
"direct": false,
"version": "8.14.1",
"ecosystem": "npm"
},
{
"name": "acorn-walk",
"direct": false,
"version": "8.3.4",
"ecosystem": "npm"
},
{
"name": "ansi-colors",
"direct": false,
"version": "4.1.3",
"ecosystem": "npm"
},
{
"name": "ansi-escapes",
"direct": false,
"version": "4.3.2",
"ecosystem": "npm"
},
{
"name": "ansi-regex",
"direct": false,
"version": "5.0.1",
"ecosystem": "npm"
},
{
"name": "ansi-styles",
"direct": false,
"version": "4.3.0",
"ecosystem": "npm"
},
{
"name": "arg",
"direct": false,
"version": "4.1.3",
"ecosystem": "npm"
},
{
"name": "argparse",
"direct": false,
"version": "1.0.10",
"ecosystem": "npm"
},
{
"name": "array-union",
"direct": false,
"version": "2.1.0",
"ecosystem": "npm"
},
{
"name": "asynckit",
"direct": false,
"version": "0.4.0",
"ecosystem": "npm"
},
{
"name": "better-path-resolve",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "body-parser",
"direct": false,
"version": "2.2.0",
"ecosystem": "npm"
},
{
"name": "braces",
"direct": false,
"version": "3.0.3",
"ecosystem": "npm"
},
{
"name": "bytes",
"direct": false,
"version": "3.1.2",
"ecosystem": "npm"
},
{
"name": "call-bind-apply-helpers",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "call-bound",
"direct": false,
"version": "1.0.4",
"ecosystem": "npm"
},
{
"name": "chardet",
"direct": false,
"version": "0.7.0",
"ecosystem": "npm"
},
{
"name": "ci-info",
"direct": false,
"version": "3.9.0",
"ecosystem": "npm"
},
{
"name": "cli-width",
"direct": false,
"version": "4.1.0",
"ecosystem": "npm"
},
{
"name": "color-convert",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "color-name",
"direct": false,
"version": "1.1.4",
"ecosystem": "npm"
},
{
"name": "combined-stream",
"direct": false,
"version": "1.0.8",
"ecosystem": "npm"
},
{
"name": "commander",
"direct": false,
"version": "13.1.0",
"ecosystem": "npm"
},
{
"name": "content-disposition",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "content-type",
"direct": false,
"version": "1.0.5",
"ecosystem": "npm"
},
{
"name": "cookie",
"direct": false,
"version": "0.7.2",
"ecosystem": "npm"
},
{
"name": "cookie-signature",
"direct": false,
"version": "1.2.2",
"ecosystem": "npm"
},
{
"name": "cors",
"direct": false,
"version": "2.8.5",
"ecosystem": "npm"
},
{
"name": "create-require",
"direct": false,
"version": "1.1.1",
"ecosystem": "npm"
},
{
"name": "cross-spawn",
"direct": false,
"version": "7.0.6",
"ecosystem": "npm"
},
{
"name": "debug",
"direct": false,
"version": "4.4.0",
"ecosystem": "npm"
},
{
"name": "delayed-stream",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "depd",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "detect-indent",
"direct": false,
"version": "6.1.0",
"ecosystem": "npm"
},
{
"name": "diff",
"direct": false,
"version": "4.0.2",
"ecosystem": "npm"
},
{
"name": "dir-glob",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "dunder-proto",
"direct": false,
"version": "1.0.1",
"ecosystem": "npm"
},
{
"name": "ee-first",
"direct": false,
"version": "1.1.1",
"ecosystem": "npm"
},
{
"name": "emoji-regex",
"direct": false,
"version": "8.0.0",
"ecosystem": "npm"
},
{
"name": "encodeurl",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "enquirer",
"direct": false,
"version": "2.4.1",
"ecosystem": "npm"
},
{
"name": "es-define-property",
"direct": false,
"version": "1.0.1",
"ecosystem": "npm"
},
{
"name": "es-errors",
"direct": false,
"version": "1.3.0",
"ecosystem": "npm"
},
{
"name": "es-object-atoms",
"direct": false,
"version": "1.1.1",
"ecosystem": "npm"
},
{
"name": "es-set-tostringtag",
"direct": false,
"version": "2.1.0",
"ecosystem": "npm"
},
{
"name": "escape-html",
"direct": false,
"version": "1.0.3",
"ecosystem": "npm"
},
{
"name": "esprima",
"direct": false,
"version": "4.0.1",
"ecosystem": "npm"
},
{
"name": "etag",
"direct": false,
"version": "1.8.1",
"ecosystem": "npm"
},
{
"name": "eventsource",
"direct": false,
"version": "3.0.7",
"ecosystem": "npm"
},
{
"name": "eventsource-parser",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "express-rate-limit",
"direct": false,
"version": "7.5.0",
"ecosystem": "npm"
},
{
"name": "extendable-error",
"direct": false,
"version": "0.1.7",
"ecosystem": "npm"
},
{
"name": "external-editor",
"direct": false,
"version": "3.1.0",
"ecosystem": "npm"
},
{
"name": "fast-glob",
"direct": false,
"version": "3.3.3",
"ecosystem": "npm"
},
{
"name": "fastq",
"direct": false,
"version": "1.19.1",
"ecosystem": "npm"
},
{
"name": "fflate",
"direct": false,
"version": "0.8.2",
"ecosystem": "npm"
},
{
"name": "fill-range",
"direct": false,
"version": "7.1.1",
"ecosystem": "npm"
},
{
"name": "finalhandler",
"direct": false,
"version": "2.1.0",
"ecosystem": "npm"
},
{
"name": "find-up",
"direct": false,
"version": "4.1.0",
"ecosystem": "npm"
},
{
"name": "flora-colossus",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "follow-redirects",
"direct": false,
"version": "1.15.9",
"ecosystem": "npm"
},
{
"name": "forwarded",
"direct": false,
"version": "0.2.0",
"ecosystem": "npm"
},
{
"name": "fresh",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "fs-extra",
"direct": false,
"version": "10.1.0",
"ecosystem": "npm"
},
{
"name": "fs-extra",
"direct": false,
"version": "7.0.1",
"ecosystem": "npm"
},
{
"name": "fs-extra",
"direct": false,
"version": "8.1.0",
"ecosystem": "npm"
},
{
"name": "function-bind",
"direct": false,
"version": "1.1.2",
"ecosystem": "npm"
},
{
"name": "galactus",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "get-intrinsic",
"direct": false,
"version": "1.3.0",
"ecosystem": "npm"
},
{
"name": "get-proto",
"direct": false,
"version": "1.0.1",
"ecosystem": "npm"
},
{
"name": "glob-parent",
"direct": false,
"version": "5.1.2",
"ecosystem": "npm"
},
{
"name": "globby",
"direct": false,
"version": "11.1.0",
"ecosystem": "npm"
},
{
"name": "gopd",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "graceful-fs",
"direct": false,
"version": "4.2.11",
"ecosystem": "npm"
},
{
"name": "has-symbols",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "has-tostringtag",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "hasown",
"direct": false,
"version": "2.0.2",
"ecosystem": "npm"
},
{
"name": "http-errors",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "human-id",
"direct": false,
"version": "4.1.1",
"ecosystem": "npm"
},
{
"name": "iconv-lite",
"direct": false,
"version": "0.4.24",
"ecosystem": "npm"
},
{
"name": "iconv-lite",
"direct": false,
"version": "0.6.3",
"ecosystem": "npm"
},
{
"name": "ignore",
"direct": false,
"version": "5.3.2",
"ecosystem": "npm"
},
{
"name": "ignore",
"direct": false,
"version": "7.0.5",
"ecosystem": "npm"
},
{
"name": "inherits",
"direct": false,
"version": "2.0.4",
"ecosystem": "npm"
},
{
"name": "ipaddr.js",
"direct": false,
"version": "1.9.1",
"ecosystem": "npm"
},
{
"name": "is-extglob",
"direct": false,
"version": "2.1.1",
"ecosystem": "npm"
},
{
"name": "is-fullwidth-code-point",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "is-glob",
"direct": false,
"version": "4.0.3",
"ecosystem": "npm"
},
{
"name": "is-number",
"direct": false,
"version": "7.0.0",
"ecosystem": "npm"
},
{
"name": "is-promise",
"direct": false,
"version": "4.0.0",
"ecosystem": "npm"
},
{
"name": "is-subdir",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "is-windows",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "isexe",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "js-yaml",
"direct": false,
"version": "3.14.1",
"ecosystem": "npm"
},
{
"name": "jsonfile",
"direct": false,
"version": "4.0.0",
"ecosystem": "npm"
},
{
"name": "jsonfile",
"direct": false,
"version": "6.1.0",
"ecosystem": "npm"
},
{
"name": "locate-path",
"direct": false,
"version": "5.0.0",
"ecosystem": "npm"
},
{
"name": "lodash.startcase",
"direct": false,
"version": "4.4.0",
"ecosystem": "npm"
},
{
"name": "make-error",
"direct": false,
"version": "1.3.6",
"ecosystem": "npm"
},
{
"name": "math-intrinsics",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "media-typer",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "merge-descriptors",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "merge2",
"direct": false,
"version": "1.4.1",
"ecosystem": "npm"
},
{
"name": "micromatch",
"direct": false,
"version": "4.0.8",
"ecosystem": "npm"
},
{
"name": "mime-db",
"direct": false,
"version": "1.52.0",
"ecosystem": "npm"
},
{
"name": "mime-db",
"direct": false,
"version": "1.54.0",
"ecosystem": "npm"
},
{
"name": "mime-types",
"direct": false,
"version": "2.1.35",
"ecosystem": "npm"
},
{
"name": "mime-types",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "mri",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "ms",
"direct": false,
"version": "2.1.3",
"ecosystem": "npm"
},
{
"name": "mute-stream",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "negotiator",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "node-forge",
"direct": false,
"version": "1.3.1",
"ecosystem": "npm"
},
{
"name": "object-assign",
"direct": false,
"version": "4.1.1",
"ecosystem": "npm"
},
{
"name": "object-inspect",
"direct": false,
"version": "1.13.4",
"ecosystem": "npm"
},
{
"name": "on-finished",
"direct": false,
"version": "2.4.1",
"ecosystem": "npm"
},
{
"name": "once",
"direct": false,
"version": "1.4.0",
"ecosystem": "npm"
},
{
"name": "os-tmpdir",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "outdent",
"direct": false,
"version": "0.5.0",
"ecosystem": "npm"
},
{
"name": "p-filter",
"direct": false,
"version": "2.1.0",
"ecosystem": "npm"
},
{
"name": "p-limit",
"direct": false,
"version": "2.3.0",
"ecosystem": "npm"
},
{
"name": "p-locate",
"direct": false,
"version": "4.1.0",
"ecosystem": "npm"
},
{
"name": "p-map",
"direct": false,
"version": "2.1.0",
"ecosystem": "npm"
},
{
"name": "p-try",
"direct": false,
"version": "2.2.0",
"ecosystem": "npm"
},
{
"name": "package-manager-detector",
"direct": false,
"version": "0.2.11",
"ecosystem": "npm"
},
{
"name": "parseurl",
"direct": false,
"version": "1.3.3",
"ecosystem": "npm"
},
{
"name": "path-exists",
"direct": false,
"version": "4.0.0",
"ecosystem": "npm"
},
{
"name": "path-key",
"direct": false,
"version": "3.1.1",
"ecosystem": "npm"
},
{
"name": "path-to-regexp",
"direct": false,
"version": "8.2.0",
"ecosystem": "npm"
},
{
"name": "path-type",
"direct": false,
"version": "4.0.0",
"ecosystem": "npm"
},
{
"name": "picocolors",
"direct": false,
"version": "1.1.1",
"ecosystem": "npm"
},
{
"name": "picomatch",
"direct": false,
"version": "2.3.1",
"ecosystem": "npm"
},
{
"name": "pify",
"direct": false,
"version": "4.0.1",
"ecosystem": "npm"
},
{
"name": "pkce-challenge",
"direct": false,
"version": "5.0.0",
"ecosystem": "npm"
},
{
"name": "prettier",
"direct": false,
"version": "2.8.8",
"ecosystem": "npm"
},
{
"name": "pretty-bytes",
"direct": false,
"version": "5.6.0",
"ecosystem": "npm"
},
{
"name": "proxy-addr",
"direct": false,
"version": "2.0.7",
"ecosystem": "npm"
},
{
"name": "proxy-from-env",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "qs",
"direct": false,
"version": "6.14.0",
"ecosystem": "npm"
},
{
"name": "quansync",
"direct": false,
"version": "0.2.10",
"ecosystem": "npm"
},
{
"name": "queue-microtask",
"direct": false,
"version": "1.2.3",
"ecosystem": "npm"
},
{
"name": "range-parser",
"direct": false,
"version": "1.2.1",
"ecosystem": "npm"
},
{
"name": "raw-body",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "read-yaml-file",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "resolve-from",
"direct": false,
"version": "5.0.0",
"ecosystem": "npm"
},
{
"name": "reusify",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "router",
"direct": false,
"version": "2.2.0",
"ecosystem": "npm"
},
{
"name": "run-parallel",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "safe-buffer",
"direct": false,
"version": "5.2.1",
"ecosystem": "npm"
},
{
"name": "safer-buffer",
"direct": false,
"version": "2.1.2",
"ecosystem": "npm"
},
{
"name": "semver",
"direct": false,
"version": "7.7.2",
"ecosystem": "npm"
},
{
"name": "send",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "serve-static",
"direct": false,
"version": "2.2.0",
"ecosystem": "npm"
},
{
"name": "setprototypeof",
"direct": false,
"version": "1.2.0",
"ecosystem": "npm"
},
{
"name": "shebang-command",
"direct": false,
"version": "2.0.0",
"ecosystem": "npm"
},
{
"name": "shebang-regex",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "side-channel",
"direct": false,
"version": "1.1.0",
"ecosystem": "npm"
},
{
"name": "side-channel-list",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "side-channel-map",
"direct": false,
"version": "1.0.1",
"ecosystem": "npm"
},
{
"name": "side-channel-weakmap",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "signal-exit",
"direct": false,
"version": "4.1.0",
"ecosystem": "npm"
},
{
"name": "slash",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "spawndamnit",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "sprintf-js",
"direct": false,
"version": "1.0.3",
"ecosystem": "npm"
},
{
"name": "statuses",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "string-width",
"direct": false,
"version": "4.2.3",
"ecosystem": "npm"
},
{
"name": "strip-ansi",
"direct": false,
"version": "6.0.1",
"ecosystem": "npm"
},
{
"name": "strip-bom",
"direct": false,
"version": "3.0.0",
"ecosystem": "npm"
},
{
"name": "term-size",
"direct": false,
"version": "2.2.1",
"ecosystem": "npm"
},
{
"name": "tmp",
"direct": false,
"version": "0.0.33",
"ecosystem": "npm"
},
{
"name": "to-regex-range",
"direct": false,
"version": "5.0.1",
"ecosystem": "npm"
},
{
"name": "toidentifier",
"direct": false,
"version": "1.0.1",
"ecosystem": "npm"
},
{
"name": "ts-node",
"direct": false,
"version": "10.9.2",
"ecosystem": "npm"
},
{
"name": "type-fest",
"direct": false,
"version": "0.21.3",
"ecosystem": "npm"
},
{
"name": "type-is",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "undici-types",
"direct": false,
"version": "6.21.0",
"ecosystem": "npm"
},
{
"name": "undici-types",
"direct": false,
"version": "7.16.0",
"ecosystem": "npm"
},
{
"name": "universalify",
"direct": false,
"version": "0.1.2",
"ecosystem": "npm"
},
{
"name": "universalify",
"direct": false,
"version": "2.0.1",
"ecosystem": "npm"
},
{
"name": "unpipe",
"direct": false,
"version": "1.0.0",
"ecosystem": "npm"
},
{
"name": "v8-compile-cache-lib",
"direct": false,
"version": "3.0.1",
"ecosystem": "npm"
},
{
"name": "vary",
"direct": false,
"version": "1.1.2",
"ecosystem": "npm"
},
{
"name": "which",
"direct": false,
"version": "2.0.2",
"ecosystem": "npm"
},
{
"name": "wrap-ansi",
"direct": false,
"version": "6.2.0",
"ecosystem": "npm"
},
{
"name": "wrappy",
"direct": false,
"version": "1.0.2",
"ecosystem": "npm"
},
{
"name": "yn",
"direct": false,
"version": "3.1.1",
"ecosystem": "npm"
},
{
"name": "yoctocolors-cjs",
"direct": false,
"version": "2.1.2",
"ecosystem": "npm"
},
{
"name": "zod-to-json-schema",
"direct": false,
"version": "3.24.5",
"ecosystem": "npm"
}
],
"collected": true,
"truncated": false,
"total_count": 257,
"direct_count": 6,
"indirect_count": 251
}
},
"maintainership": {
"issues": {
"open_prs": 1,
"merged_prs": 79,
"open_issues": 5,
"closed_ratio": 0.881,
"closed_issues": 37,
"closed_unmerged_prs": 11
},
"bus_factor": 1,
"bot_contributors": 3,
"top_contributors": [
{
"type": "User",
"login": "baruchiro",
"commits": 72,
"avatar_url": "https://avatars.githubusercontent.com/u/17686879?v=4"
},
{
"type": "User",
"login": "nloui",
"commits": 10,
"avatar_url": "https://avatars.githubusercontent.com/u/163761?v=4"
},
{
"type": "User",
"login": "calclavia",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/1828968?v=4"
},
{
"type": "User",
"login": "peshay",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/989010?v=4"
},
{
"type": "User",
"login": "NickChristensen",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/613826?v=4"
},
{
"type": "User",
"login": "gnodet",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/84022?v=4"
},
{
"type": "User",
"login": "klacol",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/10479772?v=4"
},
{
"type": "User",
"login": "lwsinclair",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/2829939?v=4"
},
{
"type": "User",
"login": "nickponomar",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/28644944?v=4"
},
{
"type": "User",
"login": "orgads",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/1246544?v=4"
}
],
"contributors_sampled": 17,
"top_contributor_share": 0.713
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"docker-publish.yml",
"e2e.yml",
"release.yml",
"stale.yml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"package-lock.json"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 4,
"reason": "branch protection is not maximal on development and all release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 8,
"reason": "26 out of 29 merged PRs checked by a CI test -- score normalized to 8",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 6,
"reason": "Found 16/24 approved changesets -- score normalized to 6",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 12 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 2,
"reason": "dependency not pinned by hash detected -- score normalized to 2",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "57 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "53c4b0b7c1893d2b100592d0a036ce7cc5651388",
"ran_at": "2026-08-01T20:08:11Z",
"aggregate_score": 4.5,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-08-01T02:17:54Z",
"oldest_open_prs": [
{
"number": 108,
"created_at": "2026-05-25T23:55:45Z",
"last_comment_at": "2026-07-27T02:17:46Z",
"last_comment_author": "github-actions"
}
],
"last_merged_pr_at": "2026-07-23T16:22:12Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": [
{
"number": 11,
"created_at": "2025-06-04T17:25:56Z",
"last_comment_at": "2026-07-20T02:18:01Z",
"last_comment_author": "github-actions"
},
{
"number": 54,
"created_at": "2026-02-19T01:43:59Z",
"last_comment_at": "2026-07-06T02:18:47Z",
"last_comment_author": "github-actions"
},
{
"number": 85,
"created_at": "2026-05-07T08:55:07Z",
"last_comment_at": "2026-07-11T02:17:19Z",
"last_comment_author": "github-actions"
},
{
"number": 88,
"created_at": "2026-05-08T13:14:36Z",
"last_comment_at": "2026-07-12T02:17:46Z",
"last_comment_author": "github-actions"
},
{
"number": 107,
"created_at": "2026-05-25T23:27:25Z",
"last_comment_at": "2026-07-27T02:17:45Z",
"last_comment_author": "github-actions"
}
]
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/baruchiro/paperless-mcp",
"host": "github.com",
"name": "paperless-mcp",
"owner": "baruchiro"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": "The weighted overall 51 is calibrated to 51 on the published index scale (record calibration 2026-08-02).",
"notes": [
{
"code": "overall_calibration",
"params": {
"raw": 51,
"calibrated": 51,
"calibration": "2026-08-02"
}
}
],
"value": 51,
"inputs": {
"security": 56,
"vitality": 44,
"community": 42,
"governance": 66,
"calibration": "2026-08-02",
"engineering": 42,
"ai_readiness": 66,
"weighted_overall_raw": 51
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "weak",
"name": "Vitality",
"value": 44,
"weight": 0.21,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 72,
"inputs": {
"commits_last_year": 78,
"human_commit_share": 0.8,
"days_since_last_push": 9,
"active_weeks_last_year": 24
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 9 days ago",
"points": 28.8,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 9
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "24/52 weeks with commits",
"points": 16.6,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 24
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "78 commits in the last year",
"points": 17,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 78
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 12 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "critical",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 1,
"inputs": {
"releases_count": 0
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "no releases published",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_releases_published",
"params": {}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "no releases",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_releases",
"params": {}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "no releases",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_releases",
"params": {}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "exceptional",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 12,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 12 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 12
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "weak",
"name": "Community & Adoption",
"value": 42,
"weight": 0.17,
"metrics": [
{
"key": "popularity",
"band": "weak",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 49,
"inputs": {
"forks": 33,
"stars": 135,
"watchers": 3,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "135 stars",
"points": 34.5,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 135
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "33 forks",
"points": 12.5,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 33
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "3 watchers",
"points": 1.7,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 3
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "at_risk",
"name": "Community health",
"note": null,
"notes": [],
"value": 25,
"inputs": {
"has_readme": false,
"has_license": false,
"readme_badges": null,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"readme_badge_services": [],
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (ISC)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "ISC"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 56,
"inputs": {
"packages": [
"@baruchiro/paperless-mcp"
],
"dependents": null,
"ecosystems": "npm",
"total_downloads": null,
"monthly_downloads": 2428
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "2,428 downloads/month across npm",
"points": 45.1,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 2428,
"ecosystems": "npm"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "good",
"name": "Sustainability & Governance",
"value": 66,
"weight": 0.23,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 32,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 17,
"top_contributor_share": 0.713
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 71% of commits",
"points": 6.5,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 71
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "17 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 17
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "excellent",
"name": "Issue & PR responsiveness",
"note": "Excluded from scoring (no data or not applicable): Newcomer PR acceptance. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"newcomer_pr_acceptance"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 83,
"inputs": {
"merged_prs": 79,
"open_issues": 5,
"closed_issues": 37,
"prs_merged_7d": null,
"prs_decided_7d": null,
"prs_merged_30d": null,
"prs_decided_30d": null,
"issue_closed_ratio": 0.881,
"closed_unmerged_prs": 11,
"first_time_authors_30d": null,
"first_time_prs_merged_30d": null,
"first_time_prs_decided_30d": null
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "88% of issues closed",
"points": 37,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 88
}
}
],
"max_points": 42
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "79/90 decided PRs merged",
"points": 26.3,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 79,
"decided": 90
}
}
],
"max_points": 30
},
{
"key": "newcomer_pr_acceptance",
"name": "Newcomer PR acceptance",
"detail": "no first-time contributor's PR decided in 30d",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_newcomer_prs",
"params": {
"days": 30
}
}
],
"max_points": 13
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 16/24 approved changesets -- score normalized to 6",
"points": 9,
"status": "partial",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 61,
"inputs": {
"followers": 80,
"owner_type": "User",
"is_verified": null,
"owner_login": "baruchiro",
"public_repos": 168,
"account_age_days": 3800
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "80 followers of baruchiro",
"points": 13.7,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 80,
"login": "baruchiro"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "168 public repos, account ~10 yr old",
"points": 25,
"status": "met",
"details": [
{
"code": "public_repos",
"params": {
"count": 168
}
},
{
"code": "account_age_years",
"params": {
"years": 10
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "exceptional",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"@baruchiro/paperless-mcp"
],
"ecosystems": "npm",
"any_deprecated": false,
"min_days_since_publish": 9
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on npm",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "npm"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 9 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 9
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "21 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 21
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "weak",
"name": "Engineering Quality",
"value": 42,
"weight": 0.19,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 64,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "5 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 5
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "26 out of 29 merged PRs checked by a CI test -- score normalized to 8",
"points": 16,
"status": "partial",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "critical",
"name": "Documentation",
"note": null,
"notes": [],
"value": 10,
"inputs": {
"topics": [
"ai",
"document-management",
"mcp",
"mcp-server",
"paperless-ngx"
],
"has_wiki": false,
"homepage": null,
"has_readme": false,
"has_docs_dir": false,
"has_description": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "5 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 5
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 56,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "weak",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 45,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 17,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 1,
"scorecard_aggregate": 4.5
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection is not maximal on development and all release branches",
"points": 3,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "26 out of 29 merged PRs checked by a CI test -- score normalized to 8",
"points": 2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 16/24 approved changesets -- score normalized to 6",
"points": 4.5,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 12 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 2",
"points": 1,
"status": "partial",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "57 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "exceptional",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the npm:@baruchiro/paperless-mcp@2.0.1 runtime dependency closure — what installing the published package pulls in — 109 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "npm:@baruchiro/paperless-mcp@2.0.1",
"assessed": 109
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 109,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "exceptional",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 109,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "exceptional",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"commit_weight_rule": {
"min_commits": 50,
"min_commit_share": 0.1
},
"review_only_matches": 0,
"below_threshold_exposures": [],
"assessed_self_published_locations": 13
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "good",
"name": "AI Readiness",
"value": 66,
"weight": 0.04,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.762,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 19079
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "CLAUDE.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "61 of 80 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 61,
"sampled": 80
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"package-lock.json"
],
"has_dockerfile": true,
"typed_language": true,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"tsconfig.json"
],
"agent_commit_share": 0.36,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "tsconfig.json",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "tsconfig.json"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "Dockerfile, lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Dockerfile, lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "36 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 36,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 2",
"points": 2,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "exceptional",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"primary_language": "TypeScript",
"largest_source_bytes": 37202,
"source_files_sampled": 34,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "TypeScript (statically typed)",
"points": 45,
"status": "met",
"details": [
{
"code": "statically_typed_language",
"params": {
"language": "TypeScript"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/34 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 34,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 20,
"inputs": {
"example_dirs": [],
"has_mcp_signal": true,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 20,
"status": "met",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero)."
}
],
"classification": {
"top": [
"library",
"application"
],
"labels": [
"mcp-server",
"library",
"network-service"
],
"scores": {
"library": 6,
"mcp-server": 9,
"network-service": 4
},
"primary": "mcp-server",
"evidence": [
{
"tier": "distribution",
"label": "library",
"source": "registry:npm",
"weight": 6
},
{
"tier": "dependencies",
"label": "mcp-server",
"source": "dep:@modelcontextprotocol/sdk",
"weight": 4
},
{
"tier": "dependencies",
"label": "network-service",
"source": "dep:express",
"weight": 4
},
{
"tier": "structure",
"label": "mcp-server",
"source": "mcp_signal",
"weight": 3
},
{
"tier": "tags",
"label": "mcp-server",
"source": "tag:mcp-server",
"weight": 2
}
],
"artifacts": [],
"confidence": "medium",
"host_extension": false,
"runs_as_process": true,
"consumed_by_code": true
},
"metrics_version": "2.5.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"Community profile unavailable"
],
"report_type": "repository",
"generated_at": "2026-08-01T20:08:34.861976Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/b/baruchiro/paperless-mcp.svg",
"full_name": "baruchiro/paperless-mcp",
"license_state": "standard",
"license_spdx": "ISC"
}