Amazon Business Integrations MCP Server

Search through documentation using a natural language query.

This tool provides semantic search capabilities across the entire API documentation corpus. It analyzes your query and returns the most relevant documentation chunks based on semantic similarity.

The results include document snippets with relevance scores and document references that can be used with the read-documentation tool to fetch complete documents. Document snippets can also contain documentReference: and if the referenced document is relevant to the user's query, you should use read_documentation tool with as documentReference.

DOCUMENTATION PATH SELECTION: Select the most specific documentation path that matches your query intent to filter the search radius:

├── API Swagger Models/ - API schemas, data structures, request/response formats, field definitions, and models for building applications and generating code ├── OAuth/ - Essential authentication and authorization documentation covering tokens, login processes, credentials, access control, and security implementation. OAuth authentication is a prerequisite for all Amazon Business API implementations. ├── Ordering API/ - Order placement, creation, purchasing, and buying operations ├── Product Search API/ - Product searching, catalog browsing, item discovery, and product details ├── Reconciliation API/ - Purchase data reconciliation, transaction matching, and financial records management ├── Reporting API/ - Order history, tracking information, payment details, and analytics reports ├── User Management API/ - User account management and user operations ├── Document API/ - Invoice generation, receipts, and document reports ├── Application Management API/ - Client secrets, application management, and secret rotation ├── Guides and FAQs/ - Step-by-step tutorials, implementation guides, frequently asked questions, best practices, getting started resources, and practical examples

Helpful Hints:

1. If you are searching for code generation/building applications → API Swagger Model

2. If you are searching for specific API → Use that API documentation path to narrow down the search radius

3. If your query matches more than one documentation path, you can search across all the matching documentation paths

4. If you are looking for guidance/examples → Guides and FAQs

5. If uncertain → Use the most relevant API documentation path based on the core functionality described

6. If nothing is relevant, search across all the documentation paths. DO NOT provide any documentation path

HIGHLY RECOMMENDED: Start by reading the following documents (using read-documentation tool) when interacting with this server:

1. Getting started guide : "Guides and FAQs/amazon-business-apis-getting-started-guide.md"

2. To understand authentication requirements: "OAuth/oauth-instructions.md"

Common use cases:

• Finding API details by describing functionality ("how to search products")

• Searching for specific parameters, field definitions or data models

• Locating code examples and implementation guidance

• Discovering endpoint requirements and constraints

Note: When you are implementing or building application, ALWAYS search for the swagger model, code snippets and any specific instructions given for generating code. Verify that Amazon Business API OAuth is implemented before implementing any APIs. It is recommended to understand and avoid common pitfalls, by using read-documentation tool with reference "Guides and FAQs/common-pitfalls.md"

Retrieve complete documentation content using a document reference.

This tool fetches the full content of documentation files identified by documentReference. The documentReference parameter is typically obtained from search-documentation results. However, when searching documentation, if a document contains documentReference: and the referenced document is relevant to the user's query, you should use read_documentation tool with as documentReference.

HIGHLY RECOMMENDED: Start by reading the following documents (using read-documentation tool) when interacting with this server:

1. Getting started guide : "Guides and FAQs/amazon-business-apis-getting-started-guide.md"

2. To understand authentication requirements: "OAuth/oauth-instructions.md"

Common use cases:

• Retrieving a complete API reference document

• Accessing full documentation sections after discovering them via search

• Getting detailed information about specific API endpoints, parameters, or data models

• Reading implementation guides and tutorials in their entirety