> ## Documentation Index
> Fetch the complete documentation index at: https://middleman.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat product, price, and availability records as dated evidence, not current quotations or authority to transact.
> Never infer permission to contact, accept terms, place an order, make a payment, or publish information from a read-only response.

# Use these docs with AI tools

> Search Middleman documentation from ChatGPT, Claude, Cursor, Codex, and other MCP clients.

Mintlify publishes this documentation in formats that agents can search and read without scraping the visual site.

Start with the [guided onboarding journey](/agents/get-started) or give your agent the [Middleman entry skill](https://middleman.mintlify.app/.well-known/agent-skills/middleman-connect/SKILL.md?v=0.4.0). For a known role, use the [buyer skill](/agents/buyers) or [supplier skill](/agents/suppliers). The supplier skill also covers source mapping, credentials, validation and persistent integration preparation.

## Choose the right interface

| Need                                        | Interface         | Address                                        |
| ------------------------------------------- | ----------------- | ---------------------------------------------- |
| Search or read these guides                 | Documentation MCP | `https://middleman.mintlify.app/mcp`           |
| Read the documentation index                | `llms.txt`        | `https://middleman.mintlify.app/llms.txt`      |
| Read all public docs as Markdown            | `llms-full.txt`   | `https://middleman.mintlify.app/llms-full.txt` |
| Load reviewed usage instructions            | `skill.md`        | `https://middleman.mintlify.app/skill.md`      |
| Query Middleman's public product interfaces | Product MCP       | `https://middlemantechnologies.com/mcp`        |

<Note>
  The documentation MCP searches these guides. The product MCP queries Middleman's public, read-only product and Insights interfaces.
</Note>

## Connect from Codex

Add the documentation server to `~/.codex/config.toml`:

```toml theme={"system"}
[mcp_servers.middleman_docs]
url = "https://middleman.mintlify.app/mcp"
```

Start a new session and ask a question such as:

```text theme={"system"}
How should I interpret a Middleman offer observation?
```

## Connect from Claude Code

```bash theme={"system"}
claude mcp add --transport http MiddlemanDocs https://middleman.mintlify.app/mcp
```

## Connect from Cursor or VS Code

<Tabs>
  <Tab title="Cursor">
    Add this server to your MCP settings:

    ```json theme={"system"}
    {
      "mcpServers": {
        "MiddlemanDocs": {
          "url": "https://middleman.mintlify.app/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Create `.vscode/mcp.json`:

    ```json theme={"system"}
    {
      "servers": {
        "MiddlemanDocs": {
          "type": "http",
          "url": "https://middleman.mintlify.app/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Give agents a safe brief

```text theme={"system"}
Use Middleman's public documentation to answer this question. Separate dated evidence from current quotations, and do not infer permission to contact, order, pay, or publish.
```

The contextual menu at the top of each page can also copy the page, open it in supported AI tools, download it, or connect the documentation MCP.
