bisibility

Save an agent analysis with provenance. Its deep link inherits existing project access controls. Producer kinds site_audit, ai_visibility and prompt_explorer are reserved and rejected here.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Create an alert rule for project rank changes, thresholds, SERP features, or competitors.

Create a new API key for the authenticated project. The raw token is returned once in the response and cannot be retrieved again; store it securely.

Create a personal access token. The raw account-wide token is returned once. Requires an admin PAT.

Create a project. Requires a personal access token with write scope.

Create a project-scoped API key for CI or automation. The raw key is returned once.

Save keyword ideas without starting paid rank tracking. Keywords already tracked or saved are skipped.

Create a saved keyword view for a project. Known country filter values: 'all' or a supported market country code such as us, gb, ca, au, de, fr, es, it, nl, se, pl. Known serp filter values: ai, featured, image, paa, sitelinks, video. The API validates both against its data-driven market list.

Ingest a signal for the key-scoped project: an external event such as a deploy, CMS content change, or custom API event that may explain ranking movements. source must be deploy, cms, or api; type is a dot-separated identifier such as "deploy.completed" or "cms.page_updated". Optionally attach an ISO-8601 happened_at (defaults to now), a related keyword_id, an http(s) url, a severity (info, warning, or critical), and a JSON payload of up to 8KB.

Invite a user to a project team with an admin, member, or viewer role.

Create a webhook endpoint. The HMAC secret is write-only.

Delete an alert rule by rule id. Use only after the user confirms deletion.

Delete one keyword by keyword id. Use only after the user confirms deletion.

Permanently delete a project and all of its keywords, rank history, and settings. This cannot be undone. Use only after the user confirms deletion.

Delete one saved keyword. Use only after the user confirms deletion.

Delete a project saved view. Use only after the user confirms deletion.

Delete a webhook endpoint. Requires admin access.

Disable the project sitemap monitor while retaining its existing snapshots.

Disconnect a provider from a project. Use only after the user confirms deletion.

Enable the project sitemap monitor. The next scheduled worker sync fetches the sitemap; enabling does not fetch immediately.

Free. Returns the cost and eligibility of a backlinks analysis without calling a provider; the paid operation is analyze_backlinks.

Free. Returns the cost and eligibility of a Domain Overview analysis without calling a provider; the paid operation is analyze_domain_overview.

Free. Returns the cost and eligibility of keyword research without calling a provider; the paid operation is research_keywords.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read original retained Local evidence and honest quality/cost uncertainty. This never launches provider work, schedules, or accounting writes.

Export project rank history as cursor-paginated JSON. Version 1 preserves legacy rows; version 2 retains raw observations/attempts, frozen scope/time and quality metadata. For full streamed CSV dumps, use the REST endpoint directly.

Read one saved analysis. A report ID never grants access to another project.

Read the free current provider AI model, locale, and cost-policy capabilities. This read never initiates paid work.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

List the public bisibility API capabilities exposed for agent workflows. public catalog; for what this session can do call get_session_profile and get_project (readiness)

Check whether a cloud export package can be imported: returns the running app version, the latest applied migration, and the cloud-import schema versions the API accepts. Anonymous preflight endpoint; no project scope or credential needed. Use before preparing a migration to confirm the export schema is still supported.

Estimate rank checks, result pages, and monthly provider cost for a keyword portfolio. Provide keywords, markets (locations), devices (1-2), and depth (10, 20, 50, or 100; default 100). Frequency supports daily, weekly, monthly, manual, paused, and custom_cron with cron_expression. Missing or invalid custom cron leaves monthly quantities and costs unknown. Pick a provider (default dataforseo) and optionally an option or plan key; see get_provider_rates. Anonymous endpoint.

Check bisibility API health and configured SERP providers.

Get a keyword and its latest rank position by keyword id, including location_key, language_code, and language_label for its exact market pair. latest_position can be null after a failed check, with unknown observation coverage, or for absence within the requested depth. Read latest_check.status and observation_completeness. Only complete coverage supports absence within depth; a positive position remains valid with truncated coverage. latest_successful_check is the most recent completed observation and can also have unknown coverage.

Requires API write scope. Paid metrics lookup uses the project's own DataForSEO account. When cost matters, call with estimate_only first for a free dry run, then use max_cost_cents as a best-effort request guard. Approximate pricing per 100 fetched keywords comes from the current rate card exposed by get_provider_rates. Batches contain up to 700 keywords and cache each keyword for 12 hours, shared with the API and UI. Clickstream-refined volumes double provider cost.

Read original retained Local evidence and honest quality/cost uncertainty. This never launches provider work, schedules, or accounting writes.

Get the authenticated user and all project memberships. Requires a personal access token.

Notification channel switches: get which channels (email, Slack, webhook) are turned on for the project. Returns no addresses or URLs; use list_webhooks for where notifications are sent.

Get one bisibility project by project id.

Read the saved business, audience, products, goals and agent rules for this project.

Get the effective rank-check schedule and SERP market defaults for a project. The response includes serp_depth, serp_stop_on_match, and source: explicit means the market was configured, derived means it was inferred from existing keywords, and fallback means the instance default was used.

List public provider rate cards used for rank-check cost estimates. Each rate card is either flat-priced (per-check options such as standard, priority, live) or plan-priced (monthly plans with included checks). Anonymous endpoint; no project scope needed.

Get one rank check result by check id. Read status and observation_completeness before interpreting position null. Only complete coverage supports absence within depth; a positive position remains valid with truncated coverage. Unknown or legacy coverage does not establish absence. error_code is a stable reason (provider_billing, provider_auth, provider_rate_limited, provider_transient); retry only for provider_rate_limited or provider_transient.

Read retained execution states, including cancelled, blocked and deferred outcomes without observations. Does not launch checks, retry provider requests or change schedules.

List historical rank checks for a keyword with date, status, and pagination filters. Read status and observation_completeness before interpreting position null. Only complete coverage supports absence within depth; a positive position remains valid with truncated coverage. Unknown or legacy coverage does not establish absence. error_code is a stable reason (provider_billing, provider_auth, provider_rate_limited, provider_transient); retry only for provider_rate_limited or provider_transient.

Report the effective profile of this MCP session: read_only, the active toolsets, tool_count, tool_names, canonical_names, and client_note. Answered locally from this server's registration; no REST call.

Read saved page signals and issues for one project crawl.

Read saved project analyses. Results are restricted to the project and its members.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Read project-scoped AI tracking evidence with original provenance, partial states, and cost uncertainty.

Alert rules: list the per-project conditions that decide when a notification fires.

List API keys for the authenticated project, including revoked keys.

List the competitor domains tracked for a project (rival sites, competing domains) with their market data such as share of voice and positions, plus competitor suggestions. Use it for competitor analysis, competing sites, and rival rankings.

List the tracked keywords (search terms) of a project with their current rankings: latest_position, previous_position, ranking_url, target URL, tags, schedule, and market. Supports pagination, search, filters, and sorting. Use it for rank positions, rank tracking, keyword rankings, and SERP position lookups. Each keyword includes location_key, language_code, and language_label for its exact market pair. latest_position can be null after a failed check, with unknown observation coverage, or for absence within the requested depth. Read latest_check.status and observation_completeness. Only compl…

Read original retained Local evidence and honest quality/cost uncertainty. This never launches provider work, schedules, or accounting writes.

Read original retained Local evidence and honest quality/cost uncertainty. This never launches provider work, schedules, or accounting writes.

Read original retained Local evidence and honest quality/cost uncertainty. This never launches provider work, schedules, or accounting writes.

List active migration tokens for a project.

List the user's personal access tokens. Requires an admin PAT.

List API keys scoped to a specific project, including revoked keys.

List projects visible to the configured credential. Project keys return one project; personal access tokens return all project memberships.

List the data provider connections of a project: SERP rank-check providers (dataforseo, serpapi) and analytics integrations (gsc, ga4, plausible), with connection status, priority, and enabled state. Use it for integrations, data sources, and provider credentials status. status is the catalog state; connection_status says whether the project can use the provider.

Read retained execution states, including cancelled, blocked and deferred outcomes without observations. Does not launch checks, retry provider requests or change schedules.

Paid provider lookup on the project's own DataForSEO account, about $0.02 per 100-keyword page on a cache miss. Results are cached for 12 hours and shared with the UI and API. already_tracked marks keywords the project tracks. Set max_cost_cents to have the server refuse a cache miss whose estimate is higher.

List keyword ideas saved without rank tracking for a project.

List saved keyword views for a project.

Fetch live query statistics from one of the project's own connected search-performance accounts. Provider rate limits and reauthorization rules apply. query is an exact match unless query_match is contains; rows aggregate all countries and devices.

List signals for a project, newest first. Filter by source (including system sources such as rank_tracker or search_analytics), exact type, and a happened-at date range via from/to ISO-8601 date-times, with cursor pagination.

Read the saved bounded crawl history for this project.

List the project sitemap monitor, including its status and latest snapshot summary.

List pending team invites for a project.

List team members for a project.

List stored page traffic snapshots collected from the project's own connected analytics accounts, filtered by date range and optional page paths.

List triggered alerts for a project.

Webhook endpoints: list the per-project HTTP URLs that notifications and events are delivered to.

Requires API write scope and an explicit max_cost_cents because a cache miss can spend provider budget. Use zero for cache-only. Loads the separately priced historical index series for an unexpired Domain Overview snapshot. snapshot_expired means analysis must run again before history can be loaded.

Requires API write scope and an explicit max_cost_cents because a cache miss can spend provider budget. Use zero for cache-only. Loads one ranked-keyword page for the current Domain Overview target; snapshot_expired means analysis must run again first.

Requires API write scope and an explicit max_cost_cents because a cache miss can spend provider budget. Use zero for cache-only. Loads one relevant-page result page for the current Domain Overview target; snapshot_expired means analysis must run again first.

Requires API write scope. Extends the current unexpired backlinks snapshot at the per-100-row provider rate. Requires the exact snapshot_ref from the latest successful analysis or append response; use the replacement reference returned by each append. Returns 409 snapshot_expired when no current snapshot exists. Stale, mismatched or expired references return 409 before provider work; read or analyze the current snapshot before retrying. This tool cannot extend failed current-response summary evidence.

Mark every firing alert in the project as read for the whole project team.

Mint a migration token for a project.

Mute one firing alert for 24 hours. This changes shared alert state for the whole project team.

Review capability, credentials, budget and price before paid AI tracking. Preview never submits a provider task.

Preview the exact current defaults draft, source revision and impact without saving or provider work. Requires the server's settings permission. Review the returned draft before explicitly confirming it with update_project_defaults; do not fabricate or automatically confirm review fields.

Remove a tracked competitor from a project.

Permanently remove a non-owner project member. Confirm the user's intent before calling this tool.

Requires API write scope. Paid keyword research uses the project's own DataForSEO account. When cost matters, call with estimate_only first for a free dry run, then use max_cost_cents as a best-effort request guard. Approximate per-source pricing comes from the current rate card exposed by get_provider_rates. Send one seed per call. Results are cached for 12 hours and shared with the API and UI. Clickstream-refined volumes double provider cost. already_tracked marks keywords the project tracks.

Resend a pending team invitation and replace its expiration and token.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Revoke an API key by key id. Revocation is immediate and cannot be undone; revoking the key this server is configured with locks the server out. Use only after the user confirms revocation.

Revoke a project migration token.

Revoke a personal token by id, or pass "current" to revoke the configured token.

Revoke a pending project team invite.

Run a provider-backed rank check for one keyword. Requires write access and may incur provider cost. Ask for explicit user approval immediately before calling; this server cannot enforce the client's confirmation UI. The deployment selects inline or queued execution. A queued response contains an rcr_ run ID, not a check_ ID. Follow get_rank_history for that run_id until terminal, then use its check_ ID with get_rank_check_result. The async option only requests an early response. Set max_cost_cents to have the server refuse the check when its preflight estimate is higher.

Crawl the project domain only, with SSRF protection, at most 15 pages and a 15-second total deadline. Save page signals and URL issues as a report. No paid provider request or Lighthouse.

Search canonical keyword markets. Use the returned location_key verbatim when creating or updating keywords so an optional @language qualifier preserves the exact location-language pair.

Set or clear the target URL used when evaluating a keyword ranking.

Deprecated compatibility tool. true promotes priority 0; false is a legacy no-op. Use set_provider_priority for new calls.

Enable or disable a provider for a project.

Set provider priority for a project. Lower numbers are preferred first.

Read the complete project context and authoritative competitors for explicit review. Returned manual templates are heuristics with no measured popularity. This never generates with a model, saves a prompt or starts paid provider work.

Synchronize traffic snapshots from the project's own connected analytics accounts now. Provider rate limits and connection authorization rules apply.

Test provider credentials or the saved provider connection. For Plausible, credentials.login is the site domain configured in Plausible (site_id) and defaults to the project domain when omitted; credentials.api_key is the Stats API token. Self-hosted providers such as Plausible accept an optional credentials.endpoint base URL. A successful test returns message "Connected." or "Connected · <detail>." for analytics providers.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Manage project-scoped AI tracking. Preserve immutable revisions, explicit budget consent, and stable retry keys. This does not start an automatic paid baseline.

Update an alert rule by rule id. The API replaces the whole rule configuration, so name and condition_type are required even when updating a single field.

Update keyword metadata such as text, country, device, target URL, tags, or schedule. Use search_locations and pass its location_key verbatim; an @language qualifier selects a non-default language for that location.

Update the authenticated user's display name. Requires a write PAT.

Notification channel switches: turn the project's notification channels (email, Slack, webhook) on or off. Does not create or change webhook endpoints; use create_webhook or update_webhook for those.

Update a project's name or domain. At least one of name or domain is required.

Replace all five context fields. Requires project write scope and a member role.

Confirm a preview_project_defaults draft using its exact source hash, revision, token and stable command key in review (confirmed:true). Missing review is refused by current servers; stale/expired review requires a new preview. Never auto-confirm. Update the project default rank-check schedule, SERP depth, and SERP market. The schedule is replaced as a whole: omitted schedule fields (frequency, cron_expression, jitter_minutes, timezone) reset to their defaults (jitter 60, timezone UTC, no cron). serp_depth and serp_stop_on_match are independent of the schedule and keep their stored values when…

Update provider settings such as enabled state or priority. primary is a deprecated compatibility alias: true promotes priority 0 and false is a no-op.

Change a non-owner project member role to admin, member, or viewer. Ownership transfer remains UI-only.

Update a webhook endpoint or rotate its write-only HMAC secret.