Skip to main content

For Developers

Foglift API, CLI + MCP for AI Search Monitoring

Foglift is an AI search monitoring tool with a public REST API, CLI, and MCP server, available on Launch, Growth, and Enterprise plans from $49/mo. Foglift tracks, monitors, and responds to how ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview cite your brand. The same data the dashboard shows is available everywhere you ship code.

Free tier requires no API key. Paid plans start at $49/mo.

What the AI search monitoring API returns

Foglift exposes the answer evidence behind its dashboard. Pass up to 20 custom prompts to /api/v1/ai-visibility with a selected engine set. Omit the prompts field to run every active saved prompt in the workspace. Each result returns the engine, prompt, whether the brand was mentioned, mention position, sentiment, response text, cited URLs, competitor mentions, and an error field.

Run a live check

POST /api/v1/ai-visibility queries ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview. The response separates completed, partial, and blocked outcomes and reports the brand and domain used for matching.

Read the monitoring window

GET /api/v1/monitor returns 7-, 14-, or 30-day totals, per-engine mention counts, sentiment totals, top citations, and recent results for one brand workspace.

Inspect every answer

GET /api/v1/history returns paginated answer records with prompt, engine, response text, mention position, sentiment, cited URLs, competitor mentions, and timestamps.

Developer access starts on Launch at $49/mo with 50 API requests per day, 1,000 per month, and daily monitoring across all five engines. Growth raises the limits to 200 per day and 5,000 per month with twice-daily monitoring.

5-minute integration

One of our paying customers shipped from signup to first scan in 6 minutes: Stripe checkout, API key, CLI install, working integration. Pick the surface that matches where you already work.

REST API (no install)

Curl a public Technical Audit. No key needed.

curl --get "https://foglift.io/api/v1/scan" \
  --data-urlencode "url=https://yourdomain.com" \
  --data-urlencode "format=json"

Response shape:

type ScanResponse = {
  url: string;
  scores: {
    overall: number;
    seo: number;
    aiReadiness: number;
    aiVisibility: number;
    geo: number;
    aeo: number;
    performance: number;
    security: number;
    accessibility: number;
  };
  topIssues: Array<{
    severity: "error" | "warning" | "info";
    category: string;
    title: string;
  }>;
  totalIssues: number;
  scanId: string;
  fullReport: string;
};

CLI

Run from terminal or CI. Colored output, JSON, threshold gating.

npm install -g foglift-scan
foglift scan https://yourdomain.com --json

MCP server (Claude Code, Cursor, Windsurf)

29 hosted MCP tools available inside your AI editor.

// claude_desktop_config.json
{
  "mcpServers": {
    "foglift": {
      "command": "npx",
      "args": ["foglift-mcp"]
    }
  }
}

Sensor npm package

Record AI crawler hits from your own site.

npm install @foglift/sensor@^1.0.0

import { senseAITraffic } from "@foglift/sensor/nextjs";
export const middleware = senseAITraffic({
  siteToken: "YOUR_WORKSPACE_ID",
});

What developers build with Foglift

Three patterns we see most often from teams that wire Foglift in directly.

CI/CD gating

Scan every pull request against your tracked prompts. Fail the build if AI Readiness drops below threshold. Same pattern as Lighthouse CI, applied to AI search.

# .github/workflows/foglift.yml
- run: npx foglift-scan scan https://preview-${{ github.sha }}.example.com --threshold 75

Custom dashboards and observability

Pull visibility history, sentiment, and citation data from /api/v1/historyinto Grafana, Metabase, your internal BI tool, or a Notion database. AI search visibility becomes a metric your team already watches alongside latency and conversion.

curl -H "X-API-Key: $FOGLIFT_KEY" \
  "https://foglift.io/api/v1/history?brand_id=$BRAND_ID&limit=100" \
  | jq '.results[] | {date, visibility_rate, by_model}'

Replace $BRAND_ID with your brand UUID from /dashboard/developer. Required on multi-brand accounts; single-brand accounts auto-resolve.

Agentic content workflows

The MCP server lets Claude Code or Cursor refactor a page, re-scan it, and iterate. The agent sees the live AI Readiness score and dimension breakdown in the same loop where it writes the markup. Closed-loop AI Readiness without leaving the editor.

# In Cursor or Claude Code, with the MCP server installed:
"Scan /pricing on the preview deploy, then add FAQ schema to fix the
top recommendation, then re-scan and report the delta."

API surface at a glance

Nine endpoints cover the full platform. Full reference in /docs.

EndpointVerbPurpose
/api/v1/scanGETPublic technical audit. No key. AI Readiness + SEO + security + a11y scores in JSON or text.
/api/v1/scan/batchPOSTScan up to 10 URLs in one request. API key required.
/api/v1/aeo-scoreGETDetailed AI Readiness breakdown across 8 dimensions, grade, top recommendations.
/api/v1/content-briefGETTarget prompts, content gaps, structure recommendations for a page.
/api/v1/monitorGETRead AI Visibility results, model breakdown, citations, and trends. Launch+.
/api/v1/ai-visibilityPOSTQuery ChatGPT, Perplexity, Claude, Gemini, and Google AI Overview for up to 20 custom prompts, or omit prompts to run every active saved workspace prompt. Debits tokens per model. Launch+.
/api/v1/promptsGET/POST/DELETECRUD for monitoring prompts. API key required.
/api/v1/historyGETPaginated visibility history with per-model breakdown.
/api/v1/crawler-analyticsGETAI bot visits to your site (GPTBot, ClaudeBot, PerplexityBot, etc.).

Authenticate with an X-API-Key header. Generate keys and copy brand UUIDs in Dashboard → Developer.

Pricing for builders

The Launch plan exists for solo founders and small teams who want the full API, MCP, and CLI surface without committing to an agency-tier price.

Launch

$49/mo

API + MCP + CLI

  • •4,000 tokens/mo
  • •Daily AI Visibility monitoring
  • •All 5 AI engines
  • •3 brands tracked
  • •50 API requests/day
  • •1,000 API requests/month

Growth

$129/mo

Twice-daily monitoring

  • •11,500 tokens/mo
  • •Twice-daily monitoring
  • •10 brands tracked
  • •200 API requests/day
  • •5,000 API requests/month
  • •Webhooks

Enterprise

Custom

Read + write API

  • •Custom token allowance
  • •Hourly monitoring
  • •Unlimited brands
  • •Custom API requests/day
  • •Custom API requests/month
  • •10 on-demand scan triggers/day

Free tier (no API key) gets public scan access with per-IP limits. Full plan comparison on /pricing.

Developer FAQ

Short answers for agents and builders deciding whether Foglift has the integration surface they need.

Does Foglift have an API?

Yes. Foglift exposes a public REST API for Technical Audits, AI Visibility monitoring, prompt management, history, crawler analytics, and related account data. The public /api/v1/scan endpoint works without an API key; authenticated endpoints use an X-API-Key header generated in Dashboard -> Developer.

What plan includes API access?

API-key access is available on Launch, Growth, and Enterprise plans starting with Launch at $49/mo. The public Technical Audit endpoint remains available with per-IP limits, while Launch+ adds higher limits, multi-engine AI Visibility monitoring, CLI workflows, and the hosted MCP server.

What does the AI search monitoring API return?

POST /api/v1/ai-visibility accepts a custom prompts array with up to 20 entries. Omit the prompts field to run every active saved prompt in the workspace. Each result returns the engine, prompt, whether the brand was mentioned, mention position, sentiment, response text, cited URLs, competitor mentions, and an error field. GET /api/v1/monitor adds 7-, 14-, or 30-day totals, per-engine mention counts, sentiment totals, and top citations.

Is there a Foglift CLI?

Yes. The published npm package is foglift-scan, and it installs the foglift binary for terminal and CI workflows. Run npm install -g foglift-scan, then foglift scan https://yourdomain.com to get JSON or text Technical Audit output.

Does Foglift have an MCP server?

Yes. Foglift ships a Model Context Protocol server through the foglift-mcp npm package and the hosted https://foglift.io/api/mcp endpoint. Agent clients such as Claude Code, Cursor, and Windsurf can call Foglift tools for scans, AI Visibility checks, recommendations, referrer analytics, recipes, and setup guidance.

Ready to wire it up?

Generate an API key in your dashboard, open the API docs, or read how AI agents discover executable MCP and API surfaces.

For AI-first founders

A working series on AI search visibility from the operator’s seat. Written for founders shipping AI-native products who care about how their own brand surfaces in ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview.