seenby

MCP & API

Your AI visibility data, inside your AI tools

Ask Claude, ChatGPT or Cursor “where are we missing in AI answers this week?” and get the answer from your Seenby data. Or call the REST API from your own code. Included in every plan.

Connect over MCP

Server URL: https://seenbyapp.com/mcp (Streamable HTTP, OAuth).

Claude

Settings → Connectors → Add custom connector, paste the server URL, then sign in to Seenby.

ChatGPT

Settings → Apps & Connectors → Create, paste the server URL with OAuth, then sign in to Seenby.

Claude Code

claude mcp add --transport http seenby https://seenbyapp.com/mcp

Cursor and others

{ "mcpServers": { "seenby": { "url": "https://seenbyapp.com/mcp" } } }

No OAuth in your client? Create an API key in Settings and send it as Authorization: Bearer sb_live_….

Tools

get_accountPlan, limits, answers used this month and tracked brandsread
get_brand_reportAction list, visibility per engine, share of voice, trend, cited domains, every question's latest resultread
get_question_historyEvery stored answer for one question, per engineread
list_cited_pagesPages the engines cited in the last 30 days, with how often you were namedread
suggest_setupReads a website and suggests brand, category, questions and competitorsread
create_brandStarts tracking a brand and runs it once (uses answers from your plan)write
run_brand_nowRe-runs a brand now, at most once an hour (uses answers from your plan)write
add_question / set_question_active / delete_questionManage tracked questionswrite
add_competitor / remove_competitorManage tracked competitorswrite
check_website / get_checkThe free three-question ChatGPT check for any websitewrite / read

Agent instructions: skill.md. Public tool list: server card.

REST API

Base URL https://seenbyapp.com/v1. Send your API key as a Bearer token. Responses are JSON; errors have an error message.

curl https://seenbyapp.com/v1/me \
  -H "Authorization: Bearer sb_live_…"
GET/v1/meAccount, plan, usage and brands
POST/v1/brandsCreate a brand (domain, name, category, prompts[], competitors[], engines[])
GET/v1/brands/{id}Full report for a brand
PATCH / DELETE/v1/brands/{id}Update or delete a brand
POST/v1/brands/{id}/runsRun a brand now
GET/v1/brands/{id}/sourcesCited pages, last 30 days
POST/v1/brands/{id}/questionsAdd a question ({text})
PATCH / DELETE/v1/questions/{id}Pause, resume ({active}) or delete a question
GET/v1/questions/{id}/historyAnswer history for a question
POST / DELETE/v1/brands/{id}/competitors, /v1/competitors/{id}Add or remove a competitor
POST/v1/suggestionsSuggested setup for a website ({domain})
POST, GET/v1/checks, /v1/checks/{id}Run and read a free check ({domain})

Questions

Does the API cost extra?
No. The MCP server and REST API are included in every plan, Free included. They use the same limits and the same monthly answers as the web app.
How do AI apps sign in?
Over OAuth: add the server URL in your AI app, sign in to Seenby in the window that opens and approve access. Apps that can't do OAuth can send an API key as a Bearer token.
Which calls use answers from my plan?
Only create_brand and run_brand_now, which ask the AI engines live: one answer per question per engine. Reading reports, history and sources is free.