{"ref":"artifact:marianfoo-sap-note-search-mcp","page":"/artifacts/marianfoo-sap-note-search-mcp","json":"/artifacts/marianfoo-sap-note-search-mcp.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"marianfoo-sap-note-search-mcp","name":"sap-note-search-mcp","artifact_type":"mcp-server","ecosystem":"btp","serves_ecosystems":["abap"],"domain":"ai-and-agents","secondary_domains":["learning-and-reference"],"origin_ring":"independent","description":{"one_line":"An MCP server over SAP Notes and Knowledge Base articles: `search` finds a note, `fetch` returns it whole, and a scripted browser does the S-user login the content sits behind.","short":"MCP server searching and fetching SAP Notes and KBAs","what_it_solves":"SAP Notes are where the answer to a specific failure is written down, and they are behind me.sap.com rather than a public API, so an agent cannot reach them. This logs in as the caller's own S-user, by username and password or an SAP Passport certificate, and caches the session cookies with a configurable lifetime. `fetch` returns a note's text together with the metadata it carries beside it: validity ranges, support packages and patches, references, prerequisites, side effects, correction summaries and attachments, and `fetch(includeCorrections=true)` adds the ABAP correction instructions through a further OData call. Two tools, no writing anywhere. It is published to npm on its own as `sap-note-search-mcp`, developed in the [sap-mcp-servers](https://github.com/marianfoo/sap-mcp-servers) monorepo beside [sap-api-hub-mcp](artifact:marianfoo-sap-api-hub-mcp) and [sap-roadmap-mcp](artifact:marianfoo-sap-roadmap-mcp), and it is the successor to the archived marianfoo/mcp-sap-notes repository.","when_not_to_use":"It needs an S-user with SAP Support Portal access, so there is nothing to search without a support contract behind the login. The maintainer states it uses private SAP APIs behind authentication, asks the reader to check whether that use breaches SAP's terms of service, and disclaims both liability and any guarantee that it keeps working. MFA is handled only by typing the code into a visible browser, so a headless deployment cannot complete a login that demands one."},"links":{"npm":"https://www.npmjs.com/package/sap-note-search-mcp","repo":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes"},"identity":{"author":"Marian Zeis","license":"Apache-2.0"},"source_available":true,"compat":{"runtimes":["node"],"typed":true},"type_properties":{"runs":{"value":["local-process"],"sources":[{"url":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes","title":"sap-mcp-servers — packages/notes README","checked":"2026-09-18","quote":"For other MCP clients, run the npm package directly with `npx`:"}]},"transports":{"value":["stdio","http"],"sources":[{"url":"https://github.com/marianfoo/sap-mcp-servers","title":"marianfoo/sap-mcp-servers — README, Running a server","checked":"2026-09-18","quote":"Each server is a stdio/HTTP MCP server."}]},"auth":{"value":["basic","x509"],"sources":[{"url":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes","title":"sap-mcp-servers — packages/notes README, Features","checked":"2026-09-18","quote":"**Two auth methods** — username/password (recommended) or SAP Passport certificate"}]},"tool_count":{"value":2,"source":{"url":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes","title":"sap-mcp-servers — packages/notes README, Features","checked":"2026-09-18","quote":"**Two MCP tools** — `search` (find notes) and `fetch` (retrieve full content + metadata)"}}},"provides":[{"capability":"capability:documentation","what_it_does":"Puts SAP Notes and Knowledge Base articles behind two tools an agent can call, returning a note's full text with its validity ranges, support packages, prerequisites, side effects and correction summaries, and optionally its ABAP correction instructions.","sources":[{"url":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes","title":"sap-mcp-servers — packages/notes README","checked":"2026-09-18","quote":"This [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server gives AI coding assistants (Cursor, Claude Desktop, VS Code, etc.) direct access to SAP Notes and Knowledge Base articles."},{"url":"https://github.com/marianfoo/sap-mcp-servers/tree/main/packages/notes","title":"sap-mcp-servers — packages/notes README, Features","checked":"2026-09-18","quote":"**Optional correction details** — `fetch(includeCorrections=true)` retrieves detailed ABAP correction instructions (affected objects, per-correction prerequisites) via an additional OData call"}]}],"maintainers":["actor:marianfoo"],"provenance":{"discovered_via":[{"source":"source:github","channel":"marianfoo"}],"first_seen":"2026-09-18"},"history":[{"date":"2026-09-18","field":"entry","from":null,"to":"created","reason":"The decline recorded for candidate:marianfoo/mcp-sap-notes on 2026-09-10 named this as the successor and as an open gap: \"SAP Notes search is a real gap in the corpus and the thing that fills it has to be found some other way.\" Entered from the monorepo package rather than the archived repository, and from the package's own README."}],"drafted_with_ai":true,"contributors":["actor:adam0thman","actor:army113","actor:marianfoo"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"released this month"},{"label":"Continuity","tier":"good","evidence":"6 contributors, 1 publisher"},{"label":"Repository","tier":"good","evidence":"pushed 2026-10, not archived"}],"compatibility":[{"label":"Declared for","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Survived majors","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Maintainer's CI","tier":"good","evidence":"CI green, 2026-10-19"}],"practice":[{"label":"Tests","tier":"good","evidence":"27 test files, npm test"},{"label":"Docs","tier":"good","evidence":"docs/ with 2 pages, README 13 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":349,"unit":"installs/week"},{"value":26,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-25","latest_version":"0.3.10","majors":{"0.3":{"version":"0.3.1","date":"2026-05-28"}},"license":"Apache-2.0","first_release":"2026-05-28","last_release":"2026-10-17","releases":10,"cadence_days":4,"maintainers":1,"repository":"git+https://github.com/marianfoo/sap-mcp-servers.git","repository_directory":"packages/notes","peer_cds":null,"dependencies":11,"node_engine":">=22.12.0","test_script":true,"types":true,"downloads_weekly":349,"downloads_monthly":1214,"stars":26,"forks":10,"open_issues":1,"archived":false,"pushed_at":"2026-10-19","license_spdx":"Apache-2.0","org_owned":false,"default_branch":"main","created_at":"2026-05-29T20:24:07Z","open_prs":1,"tree_truncated":false,"test_files":27,"workflows":2,"other_ci":false,"readme_bytes":13626,"docs_files":2,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2026-05-29","last_commit":"2026-10-19","commits":49,"contributors":6,"ci_status":"success","ci_run_at":"2026-10-19","ci_workflow":"CI","ci_event":"push","readme_path":"packages/notes/README.md","readme_sha":"8ed395d41ecd2913f6f631019a9dc4248e2e302f","months_since_release":0,"dormant":false,"repo_read":"2026-10-25"},"release_notes":{"license":"Apache-2.0","quotable":true,"source":{"kind":"repo","path":"packages/notes/CHANGELOG.md","ref":"main","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md"},"format":"conventional","releases":[{"version":"0.3.10","date":"2026-10-17","date_source":"heading","heading":"0.3.10 (2026-10-17)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#0310-2026-10-17","sections":[{"kind":"feature","heading":"Features","items":1},{"kind":"fix","heading":"Bug Fixes","items":5}],"hash":"4bcf3e2e56a3acdb"},{"version":"0.3.9","date":"2026-09-23","date_source":"heading","heading":"0.3.9 (2026-09-23)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#039-2026-09-23","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"80f24598ce2ddccc"},{"version":"0.3.8","date":"2026-09-08","date_source":"heading","heading":"0.3.8 (2026-09-08)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#038-2026-09-08","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"133ce300ae4a4db0"},{"version":"0.3.7","date":"2026-08-10","date_source":"heading","heading":"0.3.7 (2026-08-10)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#037-2026-08-10","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"7cc4b22867356cca"},{"version":"0.3.6","date":"2026-08-08","date_source":"heading","heading":"0.3.6 (2026-08-08)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#036-2026-08-08","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"5e8411f1d2ccdfe8"},{"version":"0.3.5","date":"2026-08-05","date_source":"heading","heading":"0.3.5 (2026-08-05)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#035-2026-08-05","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"f7e1a0a39970757a"},{"version":"0.3.4","date":"2026-08-01","date_source":"heading","heading":"0.3.4 (2026-08-01)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#034-2026-08-01","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"5363cbeebe3561d0"},{"version":"0.3.3","date":"2026-06-02","date_source":"heading","heading":"0.3.3 (2026-06-02)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#033-2026-06-02","sections":[{"kind":"fix","heading":"Bug Fixes","items":1}],"hash":"cf78117967be2073"},{"version":"0.3.2","date":"2026-05-29","date_source":"heading","heading":"0.3.2 (2026-05-29)","url":"https://github.com/marianfoo/sap-mcp-servers/blob/main/packages/notes/CHANGELOG.md#032-2026-05-29","sections":[{"kind":"docs","heading":"Documentation","items":1}],"hash":"ec752b6252616b01"}],"versions":[{"version":"0.3.10","date":"2026-10-17"},{"version":"0.3.9","date":"2026-09-23"},{"version":"0.3.8","date":"2026-09-08"},{"version":"0.3.7","date":"2026-08-10"},{"version":"0.3.6","date":"2026-08-08"},{"version":"0.3.5","date":"2026-08-05"},{"version":"0.3.4","date":"2026-08-01"},{"version":"0.3.3","date":"2026-06-03"},{"version":"0.3.2","date":"2026-05-29"},{"version":"0.3.1","date":"2026-05-28"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:marianfoo","name":"Marian Zeis","json":"/actors/marianfoo.json"}],"contributors":[{"ref":"actor:adam0thman","name":"adam0thman","json":"/actors/adam0thman.json"},{"ref":"actor:army113","name":"David Sluga","json":"/actors/army113.json"},{"ref":"actor:marianfoo","name":"Marian Zeis","json":"/actors/marianfoo.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[{"ref":"artifact:marianfoo-sap-api-policy-skill","name":"SAP API Policy Evidence Skill","json":"/artifacts/marianfoo-sap-api-policy-skill.json","requirement":"conditional","role":"evidence-source","condition":"an assessment is to reach the skill's high confidence level"}],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}