Ansvisor Docs

Ansvisor ships a Model Context Protocol server at https://app.ansvisor.com/api/mcp (or your own host if you self-host) so AI assistants can query your brand visibility data through natural-language conversation. No npm package, no local process — just a URL and an API key.

Generate an API key

Open your Ansvisor dashboard → Settings → API Keys
Click New key, give it a memorable name (e.g. Claude — laptop)
Copy the token. It’s shown once — store it in your password manager

Connect Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ansvisor": {
      "url": "https://app.ansvisor.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ans_..."
      }
    }
  }
}

Restart Claude Desktop. Type “List my Ansvisor brands” — Claude should call the list_brands tool and show your brands inline.

Connect Claude Code

claude mcp add ansvisor --transport http https://app.ansvisor.com/api/mcp \
  --header "Authorization: Bearer ans_..."

Self-host? Point at your own instance

The MCP endpoint lives at /api/mcp on whatever host runs the Ansvisor web app. If you self-host at ansvisor.mycompany.internal, use that base URL instead.

Available tools

Tool	What it does
`list_brands`	List brands the authenticated user can access.
`get_visibility_summary`	Aggregate visibility score, mentions, citations, top competitors for a brand over an optional date range / model / region.
`list_topics`	List the topics on a brand with a prompt count per topic. Use for coverage audits (empty / over-concentrated topics).
`list_prompts`	List the prompts tracked on a brand, optionally filtered by topic, active status, or capped via `limit`. Returns the prompt text, topic, platforms, models, regions, and active flag.

More tools land regularly — check the project roadmap.

Try it

Ask your client things like:

“List my Ansvisor brands.”
“What’s my visibility score on ChatGPT for the last 7 days?”
“Are my topics balanced?” / “Which topic has the most prompts?”
“Show me the prompts in my pricing topic.”
“Who are my top 5 competitors by mention count this month?”

The model picks the right tool, fills in the brand id and filters, and answers in plain English using the returned data.

Revoking access

If a key leaks or you stop using a client, open Settings → API Keys and click the trash icon. Clients using that key lose access immediately.

Transport

The server speaks the MCP Streamable HTTP transport in stateless mode — every request is self-contained, no session state is kept between calls. This makes it work cleanly behind any HTTP load balancer and on serverless runtimes.

Platform Guides

MCP server

Generate an API key

Connect Claude Desktop

Connect Claude Code

Self-host? Point at your own instance

Available tools

Try it

Revoking access

Transport

​Generate an API key

​Connect Claude Desktop

​Connect Claude Code

​Self-host? Point at your own instance

​Available tools

​Try it

​Revoking access

​Transport

Generate an API key

Connect Claude Desktop

Connect Claude Code

Self-host? Point at your own instance

Available tools

Try it

Revoking access

Transport