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_account | Plan, limits, answers used this month and tracked brands | read |
| get_brand_report | Action list, visibility per engine, share of voice, trend, cited domains, every question's latest result | read |
| get_question_history | Every stored answer for one question, per engine | read |
| list_cited_pages | Pages the engines cited in the last 30 days, with how often you were named | read |
| suggest_setup | Reads a website and suggests brand, category, questions and competitors | read |
| create_brand | Starts tracking a brand and runs it once (uses answers from your plan) | write |
| run_brand_now | Re-runs a brand now, at most once an hour (uses answers from your plan) | write |
| add_question / set_question_active / delete_question | Manage tracked questions | write |
| add_competitor / remove_competitor | Manage tracked competitors | write |
| check_website / get_check | The free three-question ChatGPT check for any website | write / 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/me | Account, plan, usage and brands |
| POST | /v1/brands | Create 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}/runs | Run a brand now |
| GET | /v1/brands/{id}/sources | Cited pages, last 30 days |
| POST | /v1/brands/{id}/questions | Add a question ({text}) |
| PATCH / DELETE | /v1/questions/{id} | Pause, resume ({active}) or delete a question |
| GET | /v1/questions/{id}/history | Answer history for a question |
| POST / DELETE | /v1/brands/{id}/competitors, /v1/competitors/{id} | Add or remove a competitor |
| POST | /v1/suggestions | Suggested 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.