Browse topics

MCP & AI agents

Connect Cursor, VS Code, Claude Desktop, or Claude Code to Agent3Opt using the Model Context Protocol—similar to how you might use a database MCP, but for audits, visibility, content, and A3O workflows.

What you get

The published npm package is agent3opt-mcp. It exposes tools to list notebooks, read scores and issues, run crawls and visibility probes, work with Writer drafts (on eligible plans), and more. Responses include structured JSON your agent can use to edit your own repo (metadata, MDX, public/llms.txt, etc.).

For a product-level overview of agents and artifacts, see Agents & MCP on the marketing site.

Credentials

In the dashboard, open a notebook to Integrations. Copy the API URL and Access token, and use Copy MCP config for a ready mcpServers snippet.

  • Preferred env: AGENT3OPT_API_URL, AGENT3OPT_API_KEY (optional AGENT3OPT_NOTEBOOK_ID as a hint for agents).
  • Legacy aliases CEDAR_* still work in the CLI.

Cursor and VS Code (stdio)

Add to .cursor/mcp.json or .vscode/mcp.json (merge with existing mcpServers):

{
  "mcpServers": {
    "agent3opt": {
      "command": "npx",
      "args": ["agent3opt-mcp"],
      "env": {
        "AGENT3OPT_API_URL": "https://www.agent3opt.com",
        "AGENT3OPT_API_KEY": "your_token_here"
      }
    }
  }
}

Local development

Set AGENT3OPT_API_URL to http://localhost:3000 when running the app locally.

Hosted HTTP MCP

If your client supports Streamable HTTP MCP, point it at https://www.agent3opt.com/api/mcp/sse (or your own host) and send Authorization: Bearer with your notebook token on every request.

Tools overview

Core connectivity tools include agent3opt.ping and agent3opt.get_usage. Domain tools cover SEO, AEO, A3O, visibility, on-page, readiness, integrations (GSC, GA4, Bing, GBP, PageSpeed), prompts, keywords, alerts, and Writer where your plan allows. See API and architecture for links to the full internal reference under docs/how-it-works/.

Search documentation

Jump to a docs page