GEO MCP server and API for AI agents (Claude Code, Cursor)

Q: How do I add TraceFlow Lens to Claude Code?

Create a key in your account, then run: claude mcp add --transport http traceflow-lens https://lens.traceflowlabs.com/mcp --header "Authorization: Bearer YOUR_KEY".

1. Create an API key

In your account (in French for now), “API keys” section. The key starts with lens_ and is shown only once.

2. Connect the MCP server

Server address: https://lens.traceflowlabs.com/mcp (HTTP transport, authentication with the header Authorization: Bearer YOUR_KEY).

Claude Code

claude mcp add --transport http traceflow-lens https://lens.traceflowlabs.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "traceflow-lens": {
      "url": "https://lens.traceflowlabs.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "traceflow-lens": {
      "type": "http",
      "url": "https://lens.traceflowlabs.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Windsurf (mcp_config.json)

{
  "mcpServers": {
    "traceflow-lens": {
      "serverUrl": "https://lens.traceflowlabs.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

3. Ask your agent

Run analyze_page on https://mysite.com, fix the issues in the site code by following the fix plan, then run analyze_page again to check that the score went up.

Available tools

MCP tool	What it does	REST API
`analyze_page`	Full GEO and SEO audit (33 checks), detected platform, ranked issues, fix plan	`POST /api/v1/analyze`
`check_robots_ai`	Access of Googlebot, Bingbot and 14 AI crawlers according to robots.txt	`POST /api/v1/robots`
`check_geo_citability`	GEO citability score (10 criteria)	`POST /api/v1/citabilite`
`generate_llms_txt`	llms.txt file built from the sitemap (40 pages)	`POST /api/v1/llms-txt`
`analyze_headings`	H1-H6 outline and hierarchy errors	`POST /api/v1/titres`
`list_sites`	Monitored sites and latest scores	`GET /api/v1/sites`
`add_site`	Adds a site to monitoring and starts a 200-page crawl	`POST /api/v1/sites`
`start_site_scan`	Runs the full crawl of a monitored site again	`POST /api/v1/sites/{id}/scan`
`get_site_report`	Issues across the whole site, weakest pages, fix plan	`GET /api/v1/sites/{id}`

analyze_page and POST /api/v1/analyze accept "lang": "en" to return the issues, fixes and fix plan in English.

REST API

Same tools, in JSON. Body of POST requests: {"url": "https://mysite.com", "lang": "en"}.

curl -X POST https://lens.traceflowlabs.com/api/v1/analyze \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://mysite.com", "lang": "en"}'

Limits

Solo: 100 tool calls per 24 hours. Agency: 500.
Whole-site crawls (200 pages) take a few minutes: call get_site_report again afterwards.
At most 5 active keys per account, revocable at any time.

Frequently asked questions

What is a GEO MCP server?

An MCP (Model Context Protocol) server gives tools to an AI agent such as Claude Code or Cursor. The TraceFlow Lens server lets it audit how visible a site is in Google and AI answer engines, then fix the code and check the result.

Can my agent edit a WordPress site?

If the theme code is in your project, yes. Otherwise, the agent receives the steps to follow in the WordPress admin (Yoast SEO, Rank Math) and guides you step by step.

Is the MCP server free?

It is included in the Solo (100 calls per day) and Agency (500 calls per day) plans. The free GEO tools remain open to everyone on the site.

Your AI agent audits and fixes the GEO of your site