Skip to main content
API and MCP access is included on all plans. Browse the API Reference for the full list of endpoints.
Surfacd ships an MCP server, a standard way for AI assistants to read your data and run actions on your behalf, with you approving the connection up front. Use this endpoint in any remote MCP client:
When your assistant connects, Surfacd opens a browser authorization flow at app.surfacd.com/oauth/authorize. Sign in, review the requested access, then click Authorize.

​
What the assistant can do

Once connected, the assistant has tools for:
  • Reading: list teams and projects, show a project’s brand rankings, mentions, visibility-over-time, prompts, members, source breakdowns.
  • Explaining: answer “why did visibility change?” — the assistant compares the selected period with the previous one, sees which services, countries, or topics drove the change (with noise flags), and drills into any segment before pulling example responses.
  • Reputation (projects with Reputation enabled): overview KPIs, sentiment over time and per platform, themes and narratives, the AI responses behind them, and the sources cited in those responses.
  • Writing: create projects and prompts, archive or share a project, update prompt status or tags, invite or revoke team members.
Report tools use the same filters as the product and API: platforms (services), countries, tags, and topics. Tags and topics accept a UUID or name (case-insensitive); topics also accept no_topic for uncategorised prompts. The assistant acts as you. It can do exactly what you can do logged in, and the same per-team permissions apply. It cannot bypass project prompt limits or credit budgets.

​
Connect your assistant

Claude calls remote MCP servers custom connectors. The same flow works for Claude, Cowork, and Claude Desktop.
  1. Open Customize > Connectors.
  2. Click the + button next to Connectors.
  3. Select Add custom connector.
  4. Enter Surfacd as the name.
  5. Enter https://app.surfacd.com/mcp as the URL.
  6. Complete the Surfacd authorization flow.
If you’re on a managed Claude Team or Enterprise workspace, an owner may need to add or approve the connector from organization settings first.Once connected, ask Claude something like “list my Surfacd teams” or “summarise this week’s brand visibility for Acme”.

​
Disconnect

In Claude or Cowork, go to Customize > Connectors, open the Surfacd connector, then disconnect or remove it. In ChatGPT, go to Settings > Apps & Connectors, open Surfacd, then disconnect it. Workspace admins can also disable the connector from workspace settings. In Codex:
In other clients, remove the surfacd entry from the config and restart. To revoke access from the Surfacd side (for example, if a device is lost), visit your profile page and revoke the connected application. Calls using that grant stop working immediately.

​
Safety notes

  • The assistant only sees data from teams you belong to, with the same role you have in each.
  • Destructive actions (delete a project, revoke a member) go through the same rules as the UI. A good rule of thumb: ask the assistant to confirm a destructive action before running it.
  • Tool calls don’t bypass project prompt limits or team credit budgets. If you’re at your plan’s cap, the assistant gets the same error you’d see in the UI.
  • Revoke the connection if you stop using the assistant; reconnecting is one CLI command.

​
Looking for the API instead?

If you want to call Surfacd directly from scripts or your own services, you want an API key instead. MCP is specifically for AI assistants that speak the protocol.