API Documentation

Prism 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
  1. Sign in to your Prism dashboard
  2. Go to Settings → API Keys
  3. Click "+ Create Key", name it, and select a business
  4. Copy the key — it's shown only once
Example request
curl https://apis.prismvisibility.com/api/v1/visibility-score \
  -H "X-API-Key: prism_abc123..."

Base URL

REST APIhttps://apis.prismvisibility.com
MCPhttps://mcps.prismvisibility.com

REST API Endpoints

GET/api/v1/visibility-scoreGet overall score▼
GET/api/v1/businessGet business info▼
GET/api/v1/queriesList tracked queries▼
POST/api/v1/queriesAdd a query▼
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▼

MCP Server

Connect Prism 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 Prism to any MCP-compatible client. Your API key is embedded in the URL for automatic authentication.

https://mcps.prismvisibility.com/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.prismvisibility.com/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.prismvisibility.com/sse?api_key=prism_your_key_here

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

Add Prism 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 Prism 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-engine breakdown for your business.

get_business

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

list_queries

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

add_query

Add a new query to track across AI engines.

list_scans

List recent visibility scans with status and summary scores.

get_scan_results

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

run_scan

Run a new visibility scan with specified queries and engines. Returns results when complete.

list_competitors

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

get_analytics

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

get_scan_diff

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

Rate Limits

Free
60
requests / min
Growth
300
requests / min
Scale
1000
requests / min