Skip to main content
Glama
marianfoo

SAP Note Search MCP Server

Search SAP Notes

sap_note_search

Search SAP Knowledge Base for troubleshooting articles, bug fixes, patches, and known issues to resolve SAP software errors and problems.

Instructions

Search SAP Knowledge Base (SAP Notes) for troubleshooting articles, bug fixes, patches, corrections, and known issues. Returns a ranked list of matching notes with metadata.

SAP Notes are official support articles that document: • Known bugs and their fixes • Patches and corrections for SAP software • Troubleshooting guides for specific errors • Performance optimization tips • Security vulnerabilities and patches • Missing or incorrect functionality

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ USE WHEN: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • User mentions "error", "issue", "bug", "problem", "not working" • User asks about "fixes", "patches", "corrections" • User reports unexpected behavior or incorrect functionality • User mentions specific error codes (e.g., "error 415", "dump ABAP_EXCEPTION") • User asks "why isn't this working?" or "how to fix?" • User references a specific Note ID (e.g., "Note 2744792")

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ DO NOT USE WHEN: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • User asks "how to configure" or "how to set up" → use sap_help_search instead • User wants implementation guides or best practices → use sap_help_search instead • User asks about product features or capabilities → use sap_help_search instead • User wants training materials or tutorials → use sap_community_search instead • User asks general "what is" questions → use sap_help_search instead

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ QUERY CONSTRUCTION: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Effective queries should:

  1. Include specific error codes, messages, or transaction codes

  2. Use SAP terminology (not generic terms)

  3. Be concise (2-6 words typically)

  4. Include product/module context if known

Query Formula: [Error Code/Transaction] + [Module/Component] + [Issue Type]

Examples: ✓ GOOD: • "error 415 CAP action" (specific error + context) • "MM02 material master dump" (transaction + module + issue) • "ABAP CX_SY_ZERODIVIDE" (specific exception class) • "S/4HANA migration performance" (product + issue) • "Note 2744792" (direct note ID lookup)

✗ BAD: • "how to configure SAP" (too vague, use sap_help_search) • "mm22" (transaction only, no issue context) • "I have a problem" (no specifics) • "SAP not working" (too generic)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ WORKFLOW PATTERN: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. Call sap_note_search(q="your query") to find relevant notes

  2. Review results array for relevant note IDs

  3. Call sap_note_get(id="note_id") for detailed content of top 2-3 notes

  4. Synthesize answer from fetched note content

Example Chain: sap_note_search(q="OData gateway error") → Returns: [{id: "2744792", title: "OData Gateway 415 Error"}, ...] → Then call: sap_note_get(id="2744792") → Returns: Full note content with solution

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ IMPORTANT NOTES: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • SAP Notes require S-user credentials to access full content • Note IDs are typically alphanumeric (e.g., "2744792", "438342", "123ABC") • Results are ranked by relevance (best matches first) • Empty results suggest trying sap_help_search instead • Language parameter defaults to English (EN)

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
qYesSearch query: Specific error codes, transaction codes, component names, or issue descriptions. Use concise SAP terminology (2-6 words). Examples of effective queries: • "OData gateway error" - Specific error with context • "MM02 material master dump" - Transaction + module + issue • "ABAP CX_SY_ZERODIVIDE" - Specific exception class • "S/4HANA migration performance" - Product + issue • "Note 2744792" - Direct note ID lookup • "error 415 CAP" - Error code + technology • "Fiori launchpad not loading" - Specific symptom Query construction tips: • Include error codes, transaction codes, or component names • Use SAP terminology (not generic terms) • Be specific but concise (2-6 words typically) • Format: [Error Code/Transaction] + [Module/Component] + [Issue Type] Avoid vague queries like: "SAP problem", "not working", "help"
langNoLanguage code for search results and note content. • EN (English) - Default and recommended, most comprehensive coverage • DE (German) - Available for German-language notes Use EN unless user specifically requests German content.EN

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
queryYesThe exact search query that was executed (for reference and debugging)
resultsYesArray of matching SAP Notes, ranked by relevance (best matches first). Typical workflow after getting results: 1. Review the first 2-5 results 2. Identify the most relevant note IDs based on title and summary 3. Use sap_note_get(id) to fetch full content for top 2-3 notes 4. Synthesize the solution from the detailed note content Do NOT fetch all notes - only retrieve details for the most relevant ones.
totalResultsYesTotal number of SAP Notes found matching the search query. • 0 results: Try different search terms or use sap_help_search instead • 1-5 results: High relevance, likely good matches • 6+ results: Multiple relevant notes found Results are ranked by relevance (best matches first).
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Since no annotations are provided, the description carries the full burden of behavioral disclosure. It thoroughly explains important behavioral aspects: S-user credentials required for full content access, note ID format, ranking methodology, language defaults, and workflow patterns with sibling tools. This provides comprehensive behavioral context beyond basic functionality.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections and headings, making it easy to navigate. While comprehensive, it maintains focus on relevant information without unnecessary fluff. Some sections could be slightly more concise, but overall the structure enhances readability and information retrieval.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (search functionality with specific domain knowledge requirements), no annotations, rich input schema, and presence of an output schema, the description provides excellent completeness. It covers purpose, usage guidelines, behavioral aspects, parameter guidance, workflow patterns, and important notes, making it highly comprehensive for agent understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the baseline is 3. The description adds significant value by providing extensive query construction guidance, examples of effective vs. ineffective queries, and specific query formulas. While the schema already documents parameters well, the description's additional context about query strategy and examples enhances understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches the SAP Knowledge Base for specific types of content (troubleshooting articles, bug fixes, patches, etc.) and returns ranked results with metadata. It explicitly distinguishes this from sibling tools by explaining what SAP Notes are and what they contain, making the purpose specific and well-defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit 'USE WHEN' and 'DO NOT USE WHEN' sections with detailed scenarios and named alternatives (sap_help_search, sap_community_search). It gives clear guidance on when to use this tool versus others, including specific user queries and contexts.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/marianfoo/mcp-sap-notes'

If you have feedback or need assistance with the MCP directory API, please join our Discord server