Skip to main content
AI agents can create projects, add keywords, run checks, and read rank history. They use the same authenticated operations as other API clients.

​
What an agent can do

  • Connect and test a SERP provider.
  • Add keywords to a project.
  • Run a rank check and read the result.
  • Read ranking history and stored traffic snapshots.
  • Review, mute, or acknowledge triggered alerts.
  • Export project data or prepare a migration.

​
Connect through MCP

Bisibility exposes a Model Context Protocol (MCP) Streamable HTTP endpoint:
Use https://bisibility.com/api/mcp for the hosted production endpoint. A self-hosted client should use its own origin. The MCP server card lists the endpoint and available tools:

​
Authenticate

Send a project API key as a Bearer token. The key belongs in the HTTP Authorization header, not in a tool argument.
For REST clients, set the API root and key in the tool environment:
See Authentication for key creation and a test request.

​
Example workflow

  1. Create or select a project.
  2. Add a keyword with its country and device.
  3. Start a rank check.
  4. Poll the check until it completes.
  5. Read the keyword’s ranking history.
MCP tools and REST API v1 use the same router, so both paths return the same project data and enforce the same permissions.

​
More agent tasks

  • Discover keywords that a domain already ranks for and annotate tracked terms.
  • Research related queries, suggestions, and keyword ideas, then hydrate their metrics.
  • Query live search-performance data or start an analytics sync.
  • Generate a weekly report of ranking gains, losses, and new entries.
  • Inspect, enable, or disable sitemap monitoring for a project.

​
Available tools and schemas

MCP server card

The MCP endpoint and tool inventory.

OpenAPI

The exact REST API schema.

Capabilities

Features exposed by the production API.

Agent skills

Task-focused instructions that agents can discover.

​
Advanced discovery

These endpoints help agents discover authentication, schemas, and supported features. They are optional for a basic MCP connection.

​
Optional DNS-AID records

HTTP discovery works without DNS-AID. Operators can publish DNS records when they also want domain-level AI discovery:
DNS-AID and DNSSEC are separate operator settings. Sign the zone and publish the matching DS record before claiming authenticated DNS discovery. Verify the records with a validating resolver.