Your SEO data, readable by AI.

Claude, Cursor or any MCP client asks in plain language — LibertySEO answers with your numbers.

Cache reads are free. Live pulls are deliberate.

Without the fresh flag, tools read stored snapshots: the answer includes the snapshot date and age, and costs $0.00. When no snapshot exists, the model receives a hint with the exact price of a live call — only an explicit fresh:true spends your token, and the cost is returned in the response.

Raw provider responses are compacted into terse rows before reaching the model, so a backlink dump doesn't flood the context window.

Connect in a minute

Create a personal token in Settings → API tokens (format lseo_…), build the MCP binary from the repository, then drop this into your AI client's config:

mcp.jsonClaude · Cursor

// drop into your MCP config
{
"mcpServers": {
  "libertyseo": {
    "command": "/path/to/libertyseo-mcp",
    "env": {
      "LIBERTYSEO_URL": "http://localhost:8787",
      "LIBERTYSEO_TOKEN": "lseo_…"
    }
  }
}
}

Tokens are revocable at any moment — the AI's access ends instantly, and every call it made is visible in your usage report.

The 14 tools

tool	what it does
list_sites	your tracked sites with location and language
domain_overview	domain summary: traffic, keywords, dynamics
ranked_keywords	every keyword the domain ranks for
backlinks	backlink profile: domains, anchors, new/lost
top_pages	strongest pages by organic traffic
competitors	organic competitors of a domain
serp_check	top-10 for a keyword in a given location
serp_history	SERP history for a keyword from snapshots
keyword_ideas	keyword ideas around a seed query
keyword_metrics	volumes and metrics for a keyword list
competitor_gap	keyword gap: what competitors rank for and you don't
pinned_keywords	pinned keywords with current positions
usage_report	your spend report: days, endpoints, sites
site_audit	technical site audit results

What a session looks like

You:  “How are example.com's pinned keywords doing?”
AI →  pinned_keywords            cache · $0.00 · snapshot from 3 days ago

You:  “Refresh the backlinks.”
AI →  backlinks                  no snapshot · live call ≈ $0.02 — proceed?
You:  “Yes.”
AI →  backlinks fresh:true       $0.02 from your token → stored for next time