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-compatible client) and ask questions inline while you work, during integration or while troubleshooting an issue.

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 instead of making something up.

Quick test

Before wiring it into an editor, you can test the MCP server directly from the terminal with the MCP Inspector (no setup required):

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

Add it as a remote MCP server from your terminal:

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

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

{
  "mcpServers": {
    "amwal-support": {
      "type": "http",
      "url": "https://docs.amwal.tech/mcp"
    }
  }
}

Add it to your workspace at .cursor/mcp.json, or globally in Cursor Settings > Features > MCP > Add New MCP Server:

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

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

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

Restart Claude Desktop after saving the configuration file.

Windsurf supports MCP servers natively. Add the server to your configuration file at ~/.codeium/windsurf/mcp_config.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.

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:

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

In Zed, add the context server to your user or project settings.json (under .zed/settings.json):

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

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.

Amwal Integration

Quick test

Connect it to your editor or agent

Example questions

On this page