Docs MCP Server¶

The Wallarm documentation is available as a read-only Model Context Protocol (MCP) server. Connect a supported AI client to it and the client can search and read the documentation directly, returning grounded, cited answers based on current Wallarm content.

The server is available over the streamable HTTP transport at:

https://mcp-docs.wallarm.com/mcp

You can copy this URL at any time from the Copy page menu in the top-right corner of any documentation page, under Add Docs MCP.

Supported clients¶

The server works with any client that supports remote MCP servers over the streamable HTTP transport, such as Claude Code, Claude Desktop, Antigravity, the Codex app and CLI, Cursor, Factory Droid, GitHub Copilot CLI, Kimi Code, and OpenCode.

Older clients that only support the deprecated HTTP+SSE transport are not supported.

Add the server¶

The exact steps depend on your client. Some clients provide a command to add the server; others read a JSON or TOML configuration file. The examples below add the server under the name wallarm-docs.

Watch the transport key, which differs between clients: most use type: "http" or a url field, Antigravity uses serverUrl, and OpenCode uses type: "remote". Use the exact key your client expects.

Claude CodeClaude DesktopAntigravityCodex AppCodex CLICursorFactory DroidGitHub Copilot CLIKimi CodeOpenCodePi

claude mcp add --transport http --scope user wallarm-docs https://mcp-docs.wallarm.com/mcp

Add the server to your MCP configuration:

{
  "mcpServers": {
    "wallarm-docs": {
      "type": "http",
      "url": "https://mcp-docs.wallarm.com/mcp"
    }
  }
}

Add the server to the MCP configuration file ~/.gemini/config/mcp_config.json, then refresh the installed servers:

{
  "mcpServers": {
    "wallarm-docs": {
      "serverUrl": "https://mcp-docs.wallarm.com/mcp"
    }
  }
}

Open Settings → MCP servers → Add server, set the name to wallarm-docs, select the Streamable HTTP transport, enter the URL https://mcp-docs.wallarm.com/mcp, and restart the app.

codex mcp add wallarm-docs --url https://mcp-docs.wallarm.com/mcp

Alternatively, add the server to ~/.codex/config.toml:

[mcp_servers.wallarm-docs]
url = "https://mcp-docs.wallarm.com/mcp"

Add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), then restart Cursor:

{
  "mcpServers": {
    "wallarm-docs": {
      "url": "https://mcp-docs.wallarm.com/mcp"
    }
  }
}

droid mcp add wallarm-docs https://mcp-docs.wallarm.com/mcp --type http

copilot mcp add --transport http wallarm-docs https://mcp-docs.wallarm.com/mcp

kimi mcp add --transport http wallarm-docs https://mcp-docs.wallarm.com/mcp

Add the server to opencode.json (project) or ~/.config/opencode/opencode.json (global):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wallarm-docs": {
      "type": "remote",
      "url": "https://mcp-docs.wallarm.com/mcp",
      "enabled": true
    }
  }
}

Pi adds MCP support through an MCP extension. Once the extension is installed, add the server:

/mcp add wallarm-docs https://mcp-docs.wallarm.com/mcp

You can copy either the standard JSON configuration or the server URL at any time from the Add Docs MCP section of the Copy page menu on any documentation page.

Available tools¶

Once connected, the server exposes the following tools to your AI client:

Tool	Description
`search_pages`	Searches the documentation for pages relevant to a query.
`get_page`	Returns the full Markdown of a documentation page.
`list_pages`	Lists the available documentation pages with their titles and paths.
`list_versions`	Lists the available documentation versions and the Wallarm node versions they correspond to.

The client decides which tools to call to answer your question and cites the exact pages it used.

A documentation version corresponds to the version of the Wallarm node required for API Security. Each version covers both Wallarm node families — NGINX Node and Native Node:

Documentation version	NGINX Node	Native Node
6.x (current)	6.x	0.14.x – 0.25.x
7.x (preview)	7.x	0.26.x and above
5.x	5.x	0.13.x and below

Limitations¶

The server is public and unauthenticated — it serves only published documentation.
It is read-only: the tools retrieve and search content but cannot modify it.
Content is available in English only.
The streamable HTTP transport is required; the deprecated HTTP+SSE transport is not supported.