Skip to main content

For Developers

AI search visibility you can integrate.

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.

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;
    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)

24 hosted MCP tools available inside your AI editor.

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

npm tracker

Record AI crawler hits from your own site.

npm install foglift-tracker

import { track } from "foglift-tracker";
track({ apiKey: process.env.FOGLIFT_API_KEY });

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 saved or custom prompts. 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
  • 100 API reads/day

Growth

$129/mo

Twice-daily monitoring

  • 11,500 tokens/mo
  • Twice-daily monitoring
  • 10 brands tracked
  • 1,000 API reads/day
  • Webhooks

Enterprise

$299/mo

Read + write API

  • 27,000 tokens/mo
  • Hourly monitoring
  • Unlimited brands
  • Unlimited API reads
  • 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.

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.