---
title: Amwal Integration (MCP)
description: Connect Amwal Integration directly to your editor or coding agent via MCP for in-context help during integration and troubleshooting.
---

# Amwal Integration

Amwal Integration is an AI assistant grounded in this documentation site. Instead of switching tabs to search these docs or message support, you can connect it directly to your editor or coding agent (Claude Code, Cursor, Claude Desktop, Windsurf, or any other [MCP](https://modelcontextprotocol.io)-compatible client) and ask questions inline while you work, during integration or while troubleshooting an issue.

<Callout type="info" title="What the assistant will and will not do">
  The assistant only answers from Amwal's documentation: it will not guess at endpoint names, invent parameters, or claim a feature "doesn't exist" just because it cannot find it. If something is not documented, it says so plainly and points you to [Getting Technical Support](/troubleshoot#getting-technical-support) instead of making something up.
</Callout>

---

## Quick test

Before wiring it into an editor, you can test the MCP server directly from the terminal with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) (no setup required):

```bash
npx @modelcontextprotocol/inspector https://docs.amwal.tech/mcp
```

This opens a local web UI where you can test the assistant with a sample question and view the response directly.

---

## Connect it to your editor or agent

<Tabs items={['Claude Code', 'Cursor', 'Claude Desktop', 'Windsurf', 'VS Code (Cline / Roo)', 'Zed']}>
  <Tab value="Claude Code">
    Add it as a remote MCP server from your terminal:

    ```bash
    claude mcp add --transport http amwal-support https://docs.amwal.tech/mcp
    ```

    Or add it directly to your project's `.mcp.json`:

    ```json
    {
      "mcpServers": {
        "amwal-support": {
          "type": "http",
          "url": "https://docs.amwal.tech/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="Cursor">
    Add it to your workspace at `.cursor/mcp.json`, or globally in **Cursor Settings > Features > MCP > Add New MCP Server**:

    ```json
    {
      "mcpServers": {
        "amwal-support": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.amwal.tech/mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab value="Claude Desktop">
    Claude Desktop uses a local stdio bridge to communicate with remote HTTP MCP servers. Add this configuration to your `claude_desktop_config.json`:

    - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

    ```json
    {
      "mcpServers": {
        "amwal-support": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.amwal.tech/mcp"]
        }
      }
    }
    ```

    Restart Claude Desktop after saving the configuration file.
  </Tab>

  <Tab value="Windsurf">
    Windsurf supports MCP servers natively. Add the server to your configuration file at `~/.codeium/windsurf/mcp_config.json`:

    ```json
    {
      "mcpServers": {
        "amwal-support": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.amwal.tech/mcp"]
        }
      }
    }
    ```

    Reload Windsurf or restart the MCP server list in settings.
  </Tab>

  <Tab value="VS Code (Cline / Roo)">
    If you use MCP extensions in VS Code such as Cline or Roo Code, open the extension MCP settings (`cline_mcp_settings.json` or `roo_code_mcp_settings.json`) and add:

    ```json
    {
      "mcpServers": {
        "amwal-support": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.amwal.tech/mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab value="Zed">
    In Zed, add the context server to your user or project `settings.json` (under `.zed/settings.json`):

    ```json
    {
      "experimental.context_servers": {
        "servers": [
          {
            "name": "amwal-support",
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://docs.amwal.tech/mcp"]
          }
        ]
      }
    }
    ```
  </Tab>
</Tabs>

Once connected, your editor or agent will have access to Amwal Integration to ask questions and receive grounded answers from the documentation.

---

## Example questions

Ask it the same way you would ask a teammate, in plain language while coding:

- "What header do I need to verify Amwal webhook signatures?"
- "Why would a payment link return `UNAUTHORIZED_MERCHANT`?"
- "What is the exact field name for the phone number in the create payment link request: is it `phoneNumber` or something else?"
- "Does Amwal support a mobile SDK, or should I use a WebView?"

For integration-pipeline use (CI checks, automated troubleshooting scripts), keep in mind the tool currently returns a single free-text answer rather than structured JSON; treat it as a Q&A assistant rather than a machine-parseable API for now.
