For the complete documentation index, see llms.txt. This page is also available as Markdown.

Access the Public Akto MCP Server

Overview

Akto hosts a public MCP (Model Context Protocol) server that lets any MCP-compatible client (Claude, Cursor, etc.) connect directly to your Akto data, without deploying or self-hosting an MCP server yourself.

Prerequisites

  • An Akto account with access to Settings

  • An MCP-compatible client (Claude, Cursor, etc.)

Configuration

1

Generate Your Akto API Key

  1. In your Akto dashboard, go to Settings → Integrations → Automation → Akto API Token

  2. Click Generate to create a new token

  3. Copy the token; you'll use it as the x-mcp-api-key value in the next step

2

Configure the MCP Server

Add the following configuration in your MCP client:

"akto-mcp-server": {
  "type": "http",
  "url": "https://mcp.akto.io/mcp",
  "headers": {
    "x-mcp-api-key": "<YOUR_AKTO_API_KEY>",
    "x-context-source": "Agentic"
  }
}

Replace <YOUR_AKTO_API_KEY> with the token generated in the previous step.

The x-context-source Header

The x-context-source header tells the MCP server which Akto product's data to serve:

Value
Product

API

Akto API Security

Agentic

Akto Argus (Agentic AI Security)

Endpoint

Akto Atlas (Agentic AI Security for Employee Endpoints)

DAST

Akto DAST

  • If x-context-source is not provided, the server defaults to API context.

  • If x-context-source is set to anything other than the four values above, the request is rejected with an error.

Most MCP clients apply a fixed headers block for the life of a server connection, so you can't switch x-context-source per question. If your work spans multiple contexts (e.g. both Agentic and Endpoint), add multiple named server entries pointing at the same URL and API key, each with a different x-context-source, and enable whichever matches what you're currently working on:

Example: configuring multiple context entries

The wrapper key below (mcpServers) may be named servers instead, depending on your client. Use whichever key your client's own MCP config expects.

Troubleshooting

  • Check the server is reachable: GET https://mcp.akto.io/health returns a liveness response and doesn't require any headers.

  • Connection fails immediately / handshake never completes: your client may depend on the streaming (GET/SSE) half of Streamable HTTP, which this server doesn't implement yet. See the note above.

  • 401 error: x-mcp-api-key is missing or invalid. Double-check the token generated in Step 1.

  • 400 error: x-context-source is set to a value other than API, Agentic, Endpoint, or DAST. Fix the value, or omit the header to default to API.

Support

If you need help with the setup:

Our team is available 24/7 to assist you with setup, troubleshooting, and best practices.

Last updated