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

# MCP server

> Connect an AI agent to the MW Payouts API through the hosted Model Context Protocol server.

The documentation site hosts a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that lets AI agents search these docs and call the MW Payouts API directly as tools.

## Server URL

```text theme={null}
https://developer.madhousewallet.com/mcp
```

## What the server exposes

* **Documentation search** — query this documentation for answers and code examples.
* **API tools** — every MW Payouts API endpoint is available as a callable tool, generated from the [API reference](/api-reference/introduction). An agent can get a quote, manage recipients, and initiate transfers on your behalf.

## Authentication

API tools carry the same authentication as the API itself: a Bearer [API key](/authentication). Your MCP client supplies the key with each call — it is handled by the client and never stored by the docs platform.

<Warning>
  An agent connected with your API key can take any action the key allows, **including initiating real payouts and deleting recipients**. Use a dedicated key, apply [IP restriction](/authentication#ip-restriction), and revoke it if exposed. Treat the key as server-side material — see [Authentication](/authentication).
</Warning>

## Connect a client

Most MCP-capable clients accept a remote server URL. Add the server, then provide your API key when prompted.

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http mw-payouts https://developer.madhousewallet.com/mcp
    ```
  </Tab>

  <Tab title="Cursor / VS Code">
    Add the server to your MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "mw-payouts": {
          "url": "https://developer.madhousewallet.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Other clients">
    Point any MCP client at the remote server URL over the streamable HTTP transport:

    ```text theme={null}
    https://developer.madhousewallet.com/mcp
    ```
  </Tab>
</Tabs>

<Tip>
  The same server is reachable from the assistant in the top-right of any docs page — open the menu and choose your tool to connect in one click.
</Tip>