@aisightline/mcp-server

MCP server for AI Sightline — monitor how your brand appears across AI platforms (ChatGPT, Google AIO, Perplexity, Claude, Gemini, Copilot) from Claude, Cursor, Windsurf, or any MCP-compatible client.

Quick Start

1. Get your API key

Sign up at aisightline.com and generate an API key at aisightline.com/api-keys. Free tier gets read-only MCP access; paid tiers unlock full read-write MCP. See aisightline.com/pricing for current plans.

2. Add to your MCP client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "aisightline": {
      "command": "npx",
      "args": ["-y", "@aisightline/mcp-server"],
      "env": {
        "AISIGHTLINE_API_KEY": "fba_your-key-here"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "aisightline": {
      "command": "npx",
      "args": ["-y", "@aisightline/mcp-server"],
      "env": {
        "AISIGHTLINE_API_KEY": "fba_your-key-here"
      }
    }
  }
}

Windsurf (.windsurf/mcp.json):

{
  "mcpServers": {
    "aisightline": {
      "command": "npx",
      "args": ["-y", "@aisightline/mcp-server"],
      "env": {
        "AISIGHTLINE_API_KEY": "fba_your-key-here"
      }
    }
  }
}

Claude Code (.mcp.json in project root):

{
  "mcpServers": {
    "aisightline": {
      "command": "npx",
      "args": ["-y", "@aisightline/mcp-server"],
      "env": {
        "AISIGHTLINE_API_KEY": "fba_your-key-here"
      }
    }
  }
}

3. Start asking questions

Once configured, you can ask your AI assistant things like:

• "How visible is my brand across AI platforms?"
• "How do I compare against my competitors?"
• "What should I do to improve my AI visibility?"
• "Is my brand mentioned when someone asks about [your category]?"
• "Which domains are cited when AI mentions my brand?"
• "Show me my tracked prompts and their results"

Tools (33)

Visibility & Scoring

check_visibility

Current AI visibility score with per-platform breakdown across ChatGPT, Google AIO, Perplexity, Claude, Gemini, and Copilot.

compare_competitors

Ranked comparison vs tracked competitors with score deltas showing where you stand.

get_trends

Historical visibility trend data points for a brand over time. Useful for charting.

• brand_id (required) — The brand ID
• from, to (optional) — Date range (YYYY-MM-DD)
• limit (optional) — Max data points

track_query

Check how a specific search query surfaces your brand across AI platforms.

• query (required) — The search query to track

Prompts & Results

manage_prompts

List, create, delete, or auto-generate tracking prompts.

• action (required) — list, create, delete, or generate
• text, promptId — Required for create / delete respectively

get_prompt_results

Per-prompt per-platform scan results with mention status and quality.

• promptId (optional) — Filter to one prompt

Recommendations & Gaps

get_suggestions

Prioritized recommendations with impact level, effort, and specific actions.

• limit (optional) — Max suggestions (default 5)

find_content_gaps

Queries where competitors appear but your brand does not. Sorted by severity with suggested actions.

• limit (optional) — Max gaps to return

Citations & Sources

get_citations

Ranked domains cited in AI responses for your brand.

• limit, platform — Optional filters

get_share_of_voice

Percentage of tracked queries where your brand appears, with per-platform breakdown and competitor comparison.

• period — 7d, 30d, 90d (default 30d)

Sentiment

get_brand_sentiment

Brand Sentiment Index (BSI): -100 to +100 score showing how positively AI platforms talk about the brand.

• brand_id (required)
• range — 7d, 30d, 90d (default 30d)

get_competitor_sentiment

BSI comparison between your brand and all tracked competitors. Ranked table.

• brand_id, range

get_sentiment_trend

BSI values over time for a specific entity (brand or competitor). Chart-ready data points.

• brand_id, entity_name (required)
• range — 30d or 90d (default 90d)

Topic Authority

get_topic_authority

Keyword-cluster authority map showing strong vs weak topics. Requires Pro tier or above.

• brand_id (required)

Domain Reporting

get_domain_leaderboard

Stack-ranked list of domains cited in AI responses for a brand. Filter by category.

• brand_id, range, category, limit

get_domain_detail

All cited URLs for a specific domain, with brand vs competitor presence per URL.

• brand_id, domain, range, limit

get_citation_categories

Distribution of citation source categories (News, Education, Brand, etc.).

• brand_id, range

Content Tools

audit_content

AI-readability audit on brand pages — scores structured data, FAQs, freshness, headings. Requires Pro tier or above.

• brand_id, optional page_urls, max_pages

generate_content

Generate AI-optimized briefs, articles, or FAQs targeting specific queries. Requires Business tier or above.

• brand_id, type (brief/article/faq), topic, target_queries, title, tone

get_schema_suggestions

Schema-markup recommendations with ready-to-use JSON-LD. Requires Starter tier or above.

• brand_id, optional page_url

Recommendations Engine

get_recommendations

Prioritized list of actions to improve AI visibility. Filter by status/type/impact. Tier-gated response shape.

• brand_id, status, type, impact, limit

accept_recommendation

Accept a recommendation (adds it to your to-do list). Requires Starter tier or higher.

• recommendation_id, optional notes

dismiss_recommendation

Dismiss a recommendation with an optional reason.

• recommendation_id, optional reason

complete_recommendation

Mark a recommendation complete — snapshots visibility score so impact can be measured. Requires Starter tier or higher.

• recommendation_id

get_recommendation_impact

Impact report: points gained, actions completed, per-recommendation score deltas. Requires Pro tier or higher.

• brand_id, range — 30d/90d/180d

Competitors

discover_competitors

Brands AI platforms mention alongside yours — potential competitors you may not be tracking.

Multi-Brand Management

list_brands

All brands in your organization with status and usage. Essential for agencies.

create_brand

Create a new brand profile.

• name, industry (required)
• website_url, description (optional)

archive_brand

Archive a brand — removes from active scanning and frees quota.

• brand_id (required)

reactivate_brand

Reactivate an archived brand — scans resume.

• brand_id (required)

Account

get_org_quota

Organization-wide quota summary: prompts used, brand count, hydration budget, per-brand keyword/competitor limits.

Prospect Reports (Outbound Sales)

get_brand

Full brand metadata including brand_segment (smb or agency). Used by the outbound sales workflow to choose the right outreach voice before generating a prospect report.

• brand_id (required)

generate_prospect_report

Generate a public, shareable prospect-report URL — a frozen snapshot of the brand's current AI visibility data, branded by segment, valid for 30 days. Returns { slug, url, summary }. The summary object is the sole data input the sales-skill prompt needs to write a Dani-voice email — no follow-up MCP calls required. Paste the URL into outreach email. Rate-limited to 10 reports per org per hour. Requires Pro tier or higher.

• brand_id (required)

The summary includes:

• brand_name, composite_score, industry, variant (smb or agency)
• sov_percent, rank, rank_total
• platform_scores per platform
• best_platform ({ name, score }) — highest non-zero platform
• worst_platforms (string[]) and zeros_count — platforms scoring zero
• top_cited_domain (excludes the brand's own domain)
• own_domain_is_top_cited (boolean)
• top_competitor ({ name, percent })
• scanned_at (ISO timestamp)

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AISIGHTLINE_API_KEY | Yes | Your API key from aisightline.com/api-keys | | AISIGHTLINE_BASE_URL | No | Override API base URL (default: https://aisightline.com) |

Example Conversations

Visibility Check:

"How visible is my brand in AI search?"

Your AI Sightline visibility score is 72/100. You're mentioned on 5 of 6 platforms. ChatGPT gives you the strongest presence (score: 85) with a direct citation. Gemini is the weakest (score: 41) with only a passing mention.

Competitive Analysis:

"How do I stack up against competitors?"

You're ranked #2 of 4 tracked brands. CompetitorA leads at 81, you're at 72 (+3 since last scan), CompetitorB is at 65, and CompetitorC trails at 48.

Prompt Monitoring:

"Which of my tracked prompts are getting the best AI coverage?"

12 of 15 prompts have at least one AI mention. "What should I look for when choosing a billing provider?" performs best — mentioned on all 6 platforms with citation-quality on ChatGPT and Perplexity.

Troubleshooting

"No API key provided"

Make sure AISIGHTLINE_API_KEY is set in your MCP client configuration's env block.

"Authentication failed"

Your API key may be invalid or expired. Generate a new one at aisightline.com/api-keys.

"This action is not available on your current plan"

Free tier gets read-only MCP. Write actions (creating brands, managing prompts, accepting recommendations) require a paid tier. See aisightline.com/pricing for current plans, then upgrade at aisightline.com/settings.

"Monthly API call limit reached"

You've hit your plan's API call limit. Upgrade your plan or wait until your billing cycle resets.

"Connection timeout"

The API has a 15-second timeout for read operations and 30 seconds for scans. If you're on a slow connection, try again. If persistent, check status.aisightline.com.

About AI Sightline

AI Sightline monitors how your brand appears across AI-powered search and assistant platforms. Track your visibility score, benchmark against competitors, and get actionable recommendations to improve your presence in AI-generated responses.

Website: aisightline.com Support: [email protected]