API Documentation

LLMSight REST API & MCP

Integrate AI visibility tracking into your workflow. Use the REST API from any language, or connect via MCP for AI agent access.

Authentication

All API requests require an API key passed in the X-API-Key header.

Getting your API key

Sign in to your LLMSight dashboard
Go to Settings → API Keys
Click "+ Create Key", name it, and select a business
Copy the key — it's shown only once

Example request

curl https://apis.llmsight.ai/api/v1/visibility-score \
  -H "X-API-Key: prism_abc123..."

Base URL

REST APIhttps://apis.llmsight.ai

MCPhttps://mcps.llmsight.ai

REST API Endpoints

GET/api/v1/visibility-scoreGet overall score▼

GET/api/v1/businessGet business info▼

GET/api/v1/queriesList tracked prompts▼

POST/api/v1/queriesAdd a prompt▼

GET/api/v1/scansList scans▼

GET/api/v1/scan/{scan_id}/statusScan status + results▼

POST/api/v1/scansRun a new scan▼

GET/api/v1/competitorsList competitors▼

GET/api/v1/analyticsFull analytics dashboard▼

GET/api/v1/scan-diffCompare two scans▼

GET/api/v1/trendsVisibility trends over time▼

GET/api/v1/content/briefsList content briefs▼

GET/api/v1/content/briefs/{brief_id}Get content brief▼

POST/api/v1/content/advisoryGenerate content briefs (5 credits)▼

GET/api/v1/content/artifactsList content artifacts▼

GET/api/v1/content/artifacts/{artifact_id}Get content artifact▼

POST/api/v1/content/generateGenerate content (5-30 credits)▼

GET/api/v1/content/artifacts/{id}/exportExport content▼

GET/api/v1/content/artifacts/{id}/versionsContent version history▼

GET/api/v1/analytics/externalSynced GSC/GA4 data▼

GET/api/v1/analytics/correlationAI × Organic correlation▼

POST/api/v1/geo-auditStart GEO audit (1 credit/page)▼

GET/api/v1/geo-audit/{audit_id}Get audit status & results▼

GET/api/v1/geo-audit/{audit_id}/pagesPage-level audit results▼

GET/api/v1/geo-auditsList audit history▼

GET/api/v1/geo-audit/compareCompare vs competitors▼

GET/api/v1/prompt-notificationsList notification configs▼

PUT/api/v1/prompt-notifications/{query_id}Set notification▼

DELETE/api/v1/prompt-notifications/{query_id}Remove notification▼

MCP Server

Connect LLMSight to AI agents via the Model Context Protocol. The MCP server exposes all API functionality as tools that Claude, Cursor, Windsurf, and other MCP-compatible AI assistants can call directly.

Quick Connect

Use this connector URL to add LLMSight to any MCP-compatible client. Your API key is embedded in the URL for automatic authentication.

https://mcps.llmsight.ai/sse?api_key=prism_your_key_here

Option 1 — JSON Config File

Add this to your claude_desktop_config.json (Claude Desktop), .cursor/mcp.json (Cursor), or equivalent MCP config.

{
  "mcpServers": {
    "prism": {
      "url": "https://mcps.llmsight.ai/sse",
      "headers": {
        "X-API-Key": "prism_your_key_here"
      }
    }
  }
}

Option 2 — Connector URL

Some clients support adding MCP servers via URL. Paste this connector URL directly — it includes your API key for auth.

https://mcps.llmsight.ai/sse?api_key=prism_your_key_here

Replace prism_your_key_here with your API key from Settings → API Keys.

Add LLMSight to Claude Desktop

1Generate an API key in Settings → API Keys (Growth or Scale plan required)

2Open Claude Desktop → Settings → Developer → Edit Config

3Paste the JSON config above (replace prism_your_key_here with your actual key)

4Restart Claude Desktop — you'll see LLMSight tools (get_visibility, run_scan, etc.) available in the tools menu

Available MCP Tools

get_visibility_score

Get the latest AI visibility score and per-source breakdown for your business.

get_business

Get business profile — name, domain, categories, products, competitors.

list_queries

List all tracked search prompts with their categories and active status.

add_query

Add a new prompt to track across AI sources.

list_scans

List recent visibility scans with status and summary scores.

get_scan_results

Get detailed results for a specific scan — per-prompt scores, AI answers, citations, competitor mentions.

run_scan

Run a new visibility scan with specified prompts and sources. Returns results when complete (20-60s).

list_competitors

List competitors detected in AI answers, ranked by mention frequency.

get_analytics

Full analytics: citation sources, entity leaderboard, cross-source matrix, competitor share, prompt reformulations, mention positions, sentiment.

get_trends

Get visibility metrics trended over time — scores, citations, competitors, sentiment across recent scans.

get_scan_diff

Compare two scans — show visibility improvements, declines, new/lost mentions.

list_content_briefs

List AI-generated content recommendations with status and type filters.

get_content_brief

Get a single content brief with full details — target queries, keywords, outline, data sources.

run_content_advisory

Generate content briefs by analyzing scan results, GEO audit, and analytics (5 credits).

list_content_artifacts

List generated content pieces — drafts, published, archived.

get_content_artifact

Get a content artifact with full body — markdown, HTML, SEO metadata, media.

generate_content

Generate content from a brief using Claude, GPT-4, or Gemini (5-30 credits).

export_content

Export a content artifact in markdown, HTML, or JSON format.

list_artifact_versions

List version history for a content artifact.

get_external_analytics

Get synced Google Search Console or Analytics data.

get_visibility_correlation

Correlate AI visibility with organic search metrics from GSC.

run_geo_audit

Start a GEO audit on your site or a competitor — crawls and scores every page for AI citation readiness.

get_geo_audit_status

Get audit status and results. Poll until completed.

get_geo_audit_pages

Get page-level results with scores, issues, and recommendations.

list_geo_audits

List all GEO audit history with scores and status.

compare_geo_audits

Compare your GEO audit scores against competitors — gap analysis per category.

list_prompt_notifications

List all prompt notification configs — what queries are being watched and for what events.

set_prompt_notification

Create or update a prompt notification — get alerted on citation, mention, or lost mention changes.

delete_prompt_notification

Remove a prompt notification — stop watching a query for changes.

Rate Limits

Free

requests / min

Growth

300

requests / min

Scale

1000

requests / min