Use with AI models

Your Zutrix data plugs into AI tools two ways: through the official MCP server (best for Claude, Cursor, and VS Code) or by pointing any REST-capable agent at the API directly. Both use the same API keys.

MCP quickstart

The zutrix-mcp-server npm package exposes Zutrix as Model Context Protocol tools (projects, rankings, SERP data, audits, backlinks, competitors, and more). No install step — clients launch it with:

npx -y -p zutrix-mcp-server zutrix-mcp

Set ZUTRIX_API_KEY to a key from zutrix.com/dashboard/settings/api — the same keys used for the REST API (see Authentication).

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zutrix": {
      "command": "npx",
      "args": ["-y", "-p", "zutrix-mcp-server", "zutrix-mcp"],
      "env": {
        "ZUTRIX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "zutrix": {
      "command": "npx",
      "args": ["-y", "-p", "zutrix-mcp-server", "zutrix-mcp"],
      "env": {
        "ZUTRIX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project root (note the servers key):

{
  "servers": {
    "zutrix": {
      "command": "npx",
      "args": ["-y", "-p", "zutrix-mcp-server", "zutrix-mcp"],
      "env": {
        "ZUTRIX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Agent skills

Five ready-made agent workflows ship alongside the MCP server. Each is a step-by-step playbook that chains MCP tools into a finished analysis — drop them into a skills-capable agent and ask in plain language:

REST-capable agents

Any agent that can make HTTP requests needs only two things: the base URL https://api.zutrix.com/v1 and an API key for the Authorization: Bearer header. The API is built for self-orientation:

• GET /v1 — public discovery index: lists every endpoint with its method, path, and summary, plus how to authenticate. One request tells an agent everything it can do.
• GET /v1/openapi.json — the full machine-readable OpenAPI 3.1 document with schemas, parameters, and response shapes.

A minimal system-prompt snippet for such an agent:

You can use the Zutrix SEO API.
Base URL: https://api.zutrix.com/v1
Auth header: Authorization: Bearer <ZUTRIX_API_KEY>
Start with GET /v1 to discover the available endpoints, or fetch
GET /v1/openapi.json for full request/response schemas.
Lists are cursor-paginated (?limit=, ?cursor=); errors carry a stable "code".