MisarSEO MCP Server

Official180 tools

by Misar-AI · TypeScript

Research keywords, track rankings, audit sites, monitor backlinks and AI-search visibility — from…

io.github.Misar-AI/misarseo-mcp (MCP Server)

The io.github.Misar-AI/misarseo-mcp Model Context Protocol (MCP) server supports SEO-focused workflows such as researching keywords, tracking rankings, auditing sites, monitoring backlinks, and monitoring AI-search visibility. Its provided description indicates these capabilities as the primary scope of the server.

🛠️ Key Features

Research keywords
Track rankings
Audit sites
Monitor backlinks
Monitor AI-search visibility

🚀 Use Cases

Keyword research workflows
Ongoing ranking tracking
Site audits
Backlink monitoring
Measuring AI-search visibility over time

⚡ Developer Benefits

Defines an MCP server scope around SEO research, audit, and monitoring tasks
Exposes a clear functional set aligned with ranking, backlink, and visibility tracking

⚠️ Limitations

Only a high-level description is provided; specific tools, parameters, and counts are not included in the available data.

Captured live from the server via tools/list.

list_projects

Lists the active projects in the user's organization. FREE — database only, charges no credits. Use this whenever you need a `projectId` for another MisarSEO tool. Returns `{id, name, domain, url}` per project; pass the `id` value as `projectId`. `domain` is null for a project that has never had one set, which is not a missing lookup — get_keyword_gap and get_link_intersect read the project's own domain from this record and refuse to run without it. Archived projects are not listed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_dashboard

One card per active project in the caller's organization: latest audit health, rank-tracker status, and trailing-7-day web-analytics sessions. FREE: database only. No SEO data provider is called and no credits are spent — GSC and backlinks are deliberately excluded from this view rather than fetched live, so calling this never spends a Search Console quota unit or a paid-provider credit. `audit`/`rankTracking`/`webAnalytics` are null on a card whose project has none of that data yet (never audited, no tracker configured, no analytics traffic) — a real 'not set up' fact, not a zero standing in for missing data.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

research_keywords

Research keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call — one research run per seed. Returns `results`, one entry per seed with `ok` — a single bad seed won't fail the batch. CHARGES CREDITS ON THE PAID DATA PROVIDER: per seed, ~30-100 credits each depending on the source, or a flat ~96 for countries served from Google Ads data (where difficulty and intent are unavailable). On the default free provider the sources are autocomplete plus the operator's own Keyword Planner account and NOTHING IS CHARGED — but volume/CPC/competition are null unless the operator configured a Keyword Planner, and null there means not measured, never zero demand. Keyword difficulty is derived for the SEED keyword only — every other returned row has a null difficulty because it was never scored, not because it is easy. Each seed returns `rowCount` (every row found) but only `topRows`, the first 20, are included in the response; say 20 when reporting what you actually saw, and use list_saved_keywords or the dashboard for the rest.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
seeds	array	required	1-5 seed keywords. Each seed is researched independently and returns related keywords with volume/difficulty/CPC. Bulk-friendly — prefer this over multiple single-seed calls.
resultLimit	any	optional	Cap on the data provider's own rows per seed. Defaults to 150. It is NOT a cap on `rowCount`: free Google Suggest ideas are appended after the cap is applied, so a seed can legitimately report more rows than this number.
includeClickstreamData	boolean	optional	Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). On the paid DataForSEO provider this DOUBLES the credit cost of each seed. Default false (standard Google-Ads-derived volumes). Ignored — no cost, no effect — for countries served from Google Ads data, and on the free data provider, whose autocomplete + Keyword Planner sources have no clickstream refinement at all.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "seeds": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "seed": {
            "type": "string",
            "minLength": 1,
            "description": "Seed keyword to research."
          },
          "locationCode": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
          },
          "languageCode": {
            "type": "string",
            "minLength": 2,
            "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
          }
        },
        "required": [
          "seed"
        ]
      },
      "description": "1-5 seed keywords. Each seed is researched independently and returns related keywords with volume/difficulty/CPC. Bulk-friendly — prefer this over multiple single-seed calls."
    },
    "resultLimit": {
      "description": "Cap on the data provider's own rows per seed. Defaults to 150. It is NOT a cap on `rowCount`: free Google Suggest ideas are appended after the cap is applied, so a seed can legitimately report more rows than this number.",
      "anyOf": [
        {
          "type": "number",
          "const": 150
        },
        {
          "type": "number",
          "const": 300
        },
        {
          "type": "number",
          "const": 500
        }
      ]
    },
    "includeClickstreamData": {
      "description": "Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). On the paid DataForSEO provider this DOUBLES the credit cost of each seed. Default false (standard Google-Ads-derived volumes). Ignored — no cost, no effect — for countries served from Google Ads data, and on the free data provider, whose autocomplete + Keyword Planner sources have no clickstream refinement at all.",
      "type": "boolean"
    }
  },
  "required": [
    "projectId",
    "seeds"
  ]
}

save_keywords

Save keywords to a project's saved-keywords list. FREE — database only, charges no credits. Idempotent: re-saving an existing keyword is a no-op. If tags are provided, missing tags may be created. Tags are appended to whatever tags a keyword already carries. Ask the user for confirmation before applying or replacing tags broadly. Keywords are normalised and de-duplicated before they are written, so `savedCount` is the number of DISTINCT keywords now saved by this call — it can be lower than the number of entries submitted, and that is the figure to report. Saving does not fetch metrics: a keyword saved here has null volume/difficulty/CPC until research_keywords has run for it.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keywords	array	required	Keywords to save (1-100).
tags	array	optional	Optional tags to attach to every saved keyword. Ask the user for explicit confirmation before using this, especially when saving many keywords or creating new tag names.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keywords": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Keywords to save (1-100)."
    },
    "tags": {
      "description": "Optional tags to attach to every saved keyword. Ask the user for explicit confirmation before using this, especially when saving many keywords or creating new tag names.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      }
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "keywords"
  ]
}

list_saved_keywords

Lists keywords saved to a project, with whatever metrics have been cached for them (search volume, difficulty, CPC) and their tags. FREE — reads MisarSEO's own database, runs no provider lookup and charges no credits. Filter by keyword text with `search`; page through with `page` and `limit` (50, 100 or 250 rows per page — any other value is rounded down to one of those), ordered by `sort`/`order`. A metric is null when nothing has ever fetched it for that keyword — saving a keyword does not measure it. Null is not zero volume and not zero difficulty; run research_keywords to fill them. `totalCount` is how many keywords match the filter, and `rows` is only the current page of them, so report both.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
search	string	optional	Optional keyword text filter.
limit	any	optional	Maximum rows to return. Defaults to 100.
page	integer	optional	1-based page number (default 1).
sort	string	optional	Sort column (default createdAt).
order	string	optional	Sort direction (default desc).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "search": {
      "description": "Optional keyword text filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "description": "Maximum rows to return. Defaults to 100.",
      "anyOf": [
        {
          "type": "number",
          "const": 50
        },
        {
          "type": "number",
          "const": 100
        },
        {
          "type": "number",
          "const": 250
        }
      ]
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based page number (default 1)."
    },
    "sort": {
      "type": "string",
      "enum": [
        "createdAt",
        "keyword",
        "searchVolume",
        "cpc",
        "competition",
        "keywordDifficulty",
        "fetchedAt"
      ],
      "description": "Sort column (default createdAt)."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default desc)."
    }
  },
  "required": [
    "projectId"
  ]
}

classify_keyword_intent

Classify 1-200 keywords' search intent from their wording: informational, navigational, commercial, transactional, or unknown. Uses the SAME wording heuristic keyword research already applies as its free-tier fallback, made directly callable for a keyword list with no research/volume data yet. FREE and purely local: no upstream call, no billing, no market dependency. Navigational detection is limited to destination/account phrasing ("login", "official website", ...) that means the same thing regardless of brand — a brand-name navigational query with no such phrasing classifies as `unknown` rather than a guessed label.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keywords	array	required	1-200 keywords to classify.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keywords": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "1-200 keywords to classify."
    }
  },
  "required": [
    "projectId",
    "keywords"
  ]
}

get_keyword_potential

Parent Topic and Traffic Potential for one keyword, built from real SERP overlap across a BOUNDED set (up to 5) of related keywords — not a full keyword-to-URL reverse index, which this codebase's free stack does not have. Parent Topic is the related keyword whose SERP shares the most top-10 organic URLs with the seed's. Traffic Potential is the seed's own volume plus the volume of every candidate whose own #1-ranking URL is the exact same page as the seed's — a bounded floor, never the true total traffic across every keyword that page ranks for. FREE — no paid provider or plan gate. Up to 7 upstream calls per cache miss, each independently cached (30 days for the combined result), so look keywords up one at a time. `parentTopic`/`trafficPotential` are null, not zero, when the bounded sample carries no qualifying evidence. A keyword whose SERP has no organic result throws SEO_DATA_UNAVAILABLE rather than returning zeros.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keyword	string	required	The keyword to analyze.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The keyword to analyze."
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "keyword"
  ]
}

get_keyword_serp_overview

Per-keyword SERP overview: a fresh live SERP snapshot for the keyword, PLUS — when this exact keyword happens to already be tracked in this project's rank tracking — its historical position trend and SERP volatility, read straight from the SAME rank-tracking services (`get_rank_keyword_history`/`get_rank_volatility_index`) already use. `tracked.isTracked: false` means this keyword is not currently tracked in any of the project's active rank-tracking configs — an honest absence, never a fabricated trend. One upstream call (the live SERP fetch, cached 12h); the rank-tracking portion is DB-only reads. `sinceDays` only affects `tracked.history` and is ignored when the keyword is not tracked.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keyword	string	required	The keyword to look up.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.
sinceDays	integer	optional	How many days of tracked history to return, 1-730 (default 365). Only meaningful when the keyword is tracked.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The keyword to look up."
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    },
    "sinceDays": {
      "description": "How many days of tracked history to return, 1-730 (default 365). Only meaningful when the keyword is tracked.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 730
    }
  },
  "required": [
    "projectId",
    "keyword"
  ]
}

get_keyword_strategy

Keyword Strategy Builder: a volume -> cluster -> page -> brief pipeline over 1-500 pasted keywords, composed entirely from existing pieces — the same bulk keyword lookup, the same shared-phrase clustering engine the saved-keyword Topic Clusters feature and get_topic_research both already use, a text-match against the project's own crawled pages, and a BOUNDED number of AI-gateway content-brief calls (one per cluster among the top few by measured volume, gated by the shared AI-gateway budget). `page.status: "existing"` on a cluster means the site already has a page ABOUT that topic (title/URL text-match), never a verified ranking claim — this codebase has no keyword-to-URL index. A cluster beyond the brief limit gets `brief: null, briefSkipped: true` — an honest 'not attempted', not an empty brief. Consumes the SAME keyword_lookups_per_day plan quota bulk lookups do (once per request) plus up to a handful of AI-gateway operations.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keywords	array	required	1-500 keywords to analyze (e.g. from a bulk research run or an export).
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keywords": {
      "minItems": 1,
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "1-500 keywords to analyze (e.g. from a bulk research run or an export)."
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "keywords"
  ]
}

get_topic_research

Content ideas for a seed keyword, composed from three sources this codebase already fetches for other features: the SERP for the seed (titles of pages already ranking for it), PAA-style questions (real autocomplete completions reframed as questions), and autocomplete keyword suggestions. Grouped into topic clusters by shared phrasing, using the same phrase-clustering engine the saved-keyword Topic Clusters feature uses. FREE — none of the three sources is billable in this codebase today. Three real upstream calls per request, so it is rate limited. NOT a Keywords-Explorer-style overlap report: this codebase has no keyword-to-URL index, so `clusters` group the REAL text of three OBSERVED sources rather than a fabricated 'what else these pages rank for'. `coverage.serpUnavailable`/`suggestionsUnavailable` mean that source could not be asked at all — distinct from that source genuinely returning nothing — and one source being unavailable never sinks the other two. Every idea not assigned to a cluster is still returned in `ungrouped`, never discarded.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keyword	string	required	The seed keyword to research.
locationCode	integer	optional	Numeric location code. Defaults to the project's stored market, else 2840 (United States).
languageCode	string	optional	Language code. Defaults to the project's stored market, else 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The seed keyword to research."
    },
    "locationCode": {
      "description": "Numeric location code. Defaults to the project's stored market, else 2840 (United States).",
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "languageCode": {
      "description": "Language code. Defaults to the project's stored market, else 'en'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 8
    }
  },
  "required": [
    "projectId",
    "keyword"
  ]
}

get_keyword_list_share_of_voice

Share of Voice across a saved keyword list: the project's own domain plus up to 3 competitor domains, scored over a saved-keyword tag ("a saved keyword list" in this codebase IS a saved-keyword tag — omit tagId/tagName to mean every saved keyword in the project). Reuses the EXACT Share of Voice computation rank tracking's own Share of Voice already uses (CTR-weighted visibility, a comparative index — never a click forecast). BILLABLE-ADJACENT: one live SERP fetch per keyword in the resolved list, up to a bounded per-run cap (see `truncated`) — a saved list carries no stored positions the way a rank-tracking config does. The project's own domain is read from the project row, never accepted as a parameter. `keywordsFailed` keywords (a SERP fetch that errored) are excluded from the computation, never counted as "ranks nowhere".

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
tagId	string	optional	The saved-keyword tag ID to treat as 'the list'. Omit with tagName to mean every saved keyword in the project.
tagName	string	optional	Alternative to tagId — the tag's name.
competitorDomains	array	optional	0-3 competitor domains (bare domain or full URL).
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "tagId": {
      "description": "The saved-keyword tag ID to treat as 'the list'. Omit with tagName to mean every saved keyword in the project.",
      "type": "string",
      "minLength": 1
    },
    "tagName": {
      "description": "Alternative to tagId — the tag's name.",
      "type": "string",
      "minLength": 1
    },
    "competitorDomains": {
      "description": "0-3 competitor domains (bare domain or full URL).",
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId"
  ]
}

get_domain_overview

Returns a high-level view of a domain's organic footprint: estimated organic traffic, organic keyword count, and a 0-100 domain authority score. Use this first for domain research. `backlinks` and `referringDomains` are ALWAYS null on this tool — no data provider feeds them here, so a null is the absence of a source, not a domain with no links. Call get_backlinks_overview for those. CHARGES CREDITS ON THE PAID DATA PROVIDER (~100-300 typical) for the organic traffic/keyword figures. On the default free provider that endpoint has no equivalent, so `organicTraffic` and `organicKeywords` come back null, nothing is charged, and only the authority score is populated. Null there means not measured — never report it as zero traffic. Read `authoritySource` before quoting `authority`: 'openpagerank' is link-graph authority, 'tranco' is a POPULARITY rank used as a stand-in and must be labelled as such; a domain outside Tranco's top million honestly returns null. A result carrying data is cached 12 hours per domain; a result with neither organic keywords nor an authority score is deliberately not cached, so retrying it re-runs the lookup.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Domain to analyze (e.g. 'example.com').
includeSubdomains	boolean	optional	Include subdomains in the domain's metrics. Defaults to false.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "description": "Domain to analyze (e.g. 'example.com')."
    },
    "includeSubdomains": {
      "default": false,
      "description": "Include subdomains in the domain's metrics. Defaults to false.",
      "type": "boolean"
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "domain"
  ]
}

get_domain_batch

Domain batch analysis: one authority row per domain, up to 100 at once. FREE — no paid provider call, unlike get_domain_overview. `organicTraffic`, `organicKeywords`, `backlinks` and `referringDomains` are ALWAYS null on every row — batch mode never attempts the per-domain paid rank-overview call the single-domain overview makes, since fanning that out across many domains in one call is a materially bigger paid-provider commitment than anything else this codebase does in one request. `organicUnavailableReason` states this once for the whole response; use get_domain_overview for organic figures on one domain at a time. Malformed domain entries are dropped and counted in `skippedInvalid` rather than failing the whole call. `authorityUnavailableReason` is set only when the authority provider itself failed to answer — null authority on every row without it set means every domain was looked up and found unranked, not that nothing could be looked up.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domains	array	required	1-100 domains or URLs, any mix. Malformed entries are dropped, not rejected — see skippedInvalid in the result.
includeSubdomains	boolean	optional	Count subdomains as part of each domain. Defaults to false, unlike get_domain_overview's default true.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domains": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "1-100 domains or URLs, any mix. Malformed entries are dropped, not rejected — see skippedInvalid in the result."
    },
    "includeSubdomains": {
      "default": false,
      "description": "Count subdomains as part of each domain. Defaults to false, unlike get_domain_overview's default true.",
      "type": "boolean"
    }
  },
  "required": [
    "projectId",
    "domains"
  ]
}

get_domain_authority_history

Domain-authority history: the stored trend of dated authority snapshots for one project+domain, oldest first. FREE (no credits) — reads back snapshots already captured, no provider call. Empty until at least one snapshot exists: get_domain_overview auto-captures one whenever `domain` is the project's own domain, or call capture_domain_authority_snapshot directly for any domain (including a tracked competitor).

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Domain to read history for (e.g. 'example.com').

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "description": "Domain to read history for (e.g. 'example.com')."
    }
  },
  "required": [
    "projectId",
    "domain"
  ]
}

capture_domain_authority_snapshot

Capture a domain-authority snapshot now: calls the same free resolver get_domain_overview already uses and records today's reading, so get_domain_authority_history has a trend to read back. FREE (no credits), but this is a MUTATION — idempotent per UTC day, so calling it twice in one day does not write twice. Useful for a domain get_domain_overview would not auto-capture on its own — e.g. a tracked competitor rather than the project's own domain.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Domain to capture a snapshot for (e.g. 'example.com').

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "description": "Domain to capture a snapshot for (e.g. 'example.com')."
    }
  },
  "required": [
    "projectId",
    "domain"
  ]
}

find_serp_competitors

Compares domains competing in search results for a supplied keyword set. Useful for market and search-intelligence reports; not radius-based local SEO. The inverse of get_keyword_gap, which asks what one competitor ranks for that we do not. CHARGES CREDITS ON THE PAID DATA PROVIDER, which is also the only one that honours `resultTypes` and `includeSubdomains` and that measures `visibility`, `etv` and `rating`. On the default free provider competitors are aggregated from one live SERP per keyword: NOTHING IS CHARGED, only ORGANIC results are counted whatever `resultTypes` says, `includeSubdomains` is ignored, and visibility/traffic-estimate/rating are left unmeasured. Sorting never treats an unmeasured field as zero: rows the provider did not measure sort last and are reported in `unmeasuredForSort`. If that count equals the row count, the list is NOT ranked by anything — say so instead of presenting the first row as the strongest competitor. Omit `locationCode`/`languageCode` to use the project's default market.

Parameters10

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keywords	array	required	Keywords whose SERPs are compared (1-100).
resultTypes	array	optional	SERP result types to include. Defaults to organic and local_pack.
excludeDomains	array	optional	Domains to exclude from results (e.g. the user's own site).
includeSubdomains	boolean	optional	Count subdomains as part of the same competitor domain.
sortBy	string	optional	Sort order for returned competitors. Defaults to visibility. Only `keyword_count` and `avg_position` are measured on every provider — `visibility` and `traffic_estimate` are unmeasured on the free provider, and rows without the chosen field sort last rather than as zero. Prefer `keyword_count` when you need an order that always means something.
limit	integer	optional	Maximum competitors to return (1-100). Defaults to 50.
offset	integer	optional	Rows to skip for pagination.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keywords": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      },
      "description": "Keywords whose SERPs are compared (1-100)."
    },
    "resultTypes": {
      "description": "SERP result types to include. Defaults to organic and local_pack.",
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "organic",
          "paid",
          "featured_snippet",
          "local_pack"
        ]
      }
    },
    "excludeDomains": {
      "description": "Domains to exclude from results (e.g. the user's own site).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    },
    "includeSubdomains": {
      "description": "Count subdomains as part of the same competitor domain.",
      "type": "boolean"
    },
    "sortBy": {
      "description": "Sort order for returned competitors. Defaults to visibility. Only `keyword_count` and `avg_position` are measured on every provider — `visibility` and `traffic_estimate` are unmeasured on the free provider, and rows without the chosen field sort last rather than as zero. Prefer `keyword_count` when you need an order that always means something.",
      "type": "string",
      "enum": [
        "visibility",
        "traffic_estimate",
        "avg_position",
        "keyword_count"
      ]
    },
    "limit": {
      "description": "Maximum competitors to return (1-100). Defaults to 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Rows to skip for pagination.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "keywords"
  ]
}

get_keyword_gap

Compares the project's own domain against up to 3 competitor domains and classifies every keyword a competitor ranks for as missing / behind / tied / ahead / unknown. The inverse of find_serp_competitors, which asks who competes for a keyword set. CHARGES CREDITS: one ranked-keywords lookup per domain, so one call costs up to 4 upstream requests (our domain plus the competitors). Each lookup is cached 12h per domain, so re-running the same comparison with a different sort or classification filter is free — do that rather than issuing a new comparison. Compares the top 1000 keywords per domain by search volume, so a large domain is compared on a slice; per-domain `coverage` reports `keywordsFetched`, `keywordsTotal`, `truncated` and `volumeFloor`. `missing` and `unknown` are NOT interchangeable: `missing` means a competitor ranks and we provably do not; `unknown` means our own slice ran out above that keyword's volume, so nothing was measured about whether we rank. Never present `unknown` as a gap. The project's own domain is read from the project record and cannot be passed in — if the project has no domain the call fails with a validation error telling the user to set one. When `unavailable` is true, no configured data provider has a ranked-keyword source and no comparison happened; the empty `rows` in that case does NOT mean the competitors rank for nothing. At most 200 rows are returned; `totalRows` is the real match count.

Parameters8

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
competitorDomains	array	required	1–3 competitor domains (bare domain or full URL). Each one is a separate billable ranked-keywords lookup, so pick the rivals actually being chased. The project's own domain is added automatically and is ignored if it appears here.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.
includeSubdomains	boolean	optional	Count subdomains as part of a domain. Defaults to true, and applies to every compared domain including ours.
sortField	string	optional	Sort column: 'volume' (default), 'theirPosition' or 'ourPosition'. All three are measured values — there is deliberately no composite opportunity score. Nulls sort last in both directions.
sortOrder	string	optional	Sort direction. Defaults to 'desc'.
classifications	array	optional	Restrict rows to these classifications. Omit for all five — omitting never hides `unknown`. The filter is applied before the row cap, and `totalRows` reports the pre-cap match count.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "competitorDomains": {
      "minItems": 1,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "1–3 competitor domains (bare domain or full URL). Each one is a separate billable ranked-keywords lookup, so pick the rivals actually being chased. The project's own domain is added automatically and is ignored if it appears here."
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    },
    "includeSubdomains": {
      "description": "Count subdomains as part of a domain. Defaults to true, and applies to every compared domain including ours.",
      "type": "boolean"
    },
    "sortField": {
      "description": "Sort column: 'volume' (default), 'theirPosition' or 'ourPosition'. All three are measured values — there is deliberately no composite opportunity score. Nulls sort last in both directions.",
      "type": "string",
      "enum": [
        "volume",
        "theirPosition",
        "ourPosition"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Defaults to 'desc'.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "classifications": {
      "description": "Restrict rows to these classifications. Omit for all five — omitting never hides `unknown`. The filter is applied before the row cap, and `totalRows` reports the pre-cap match count.",
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "missing",
          "behind",
          "tied",
          "ahead",
          "unknown"
        ]
      }
    }
  },
  "required": [
    "projectId",
    "competitorDomains"
  ]
}

list_competitor_monitors

Competitor page change detection: the specific competitor URLs monitored for a project, with `lastCheckedAt` (null until the first scheduled check reaches it). FREE — database only, no credits spent. Use get_competitor_monitor_changes for the actual detected-change timeline of one URL.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

add_competitor_monitor

Start monitoring one competitor page for changes: title/meta, a real line-level content diff (added/removed/unchanged line counts — never a fabricated similarity score), outbound links, and structured-data types. Checked once a day; the first snapshot is captured on the NEXT scheduled pass, not immediately. FREE — this codebase's own SSRF-safe fetch, no paid provider. Idempotent (re-adding an already-tracked URL is a no-op). A project can monitor at most 20 URLs.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	The specific competitor page URL to monitor — not a domain to crawl. Normalised and SSRF-validated server-side; a URL resolving to a private/loopback/metadata address is rejected.
label	string	optional	Optional human-readable label, e.g. 'Acme pricing page'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "The specific competitor page URL to monitor — not a domain to crawl. Normalised and SSRF-validated server-side; a URL resolving to a private/loopback/metadata address is rejected."
    },
    "label": {
      "description": "Optional human-readable label, e.g. 'Acme pricing page'.",
      "type": "string",
      "maxLength": 100
    }
  },
  "required": [
    "projectId",
    "url"
  ]
}

remove_competitor_monitor

Stops monitoring one competitor URL. Its historical snapshots and detected changes are deleted along with it (cascading delete) — unlike rank tracking's competitor removal, there is no separate archive kept.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
targetId	string	required	Monitored URL's target ID, from list_competitor_monitors or add_competitor_monitor.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "targetId": {
      "type": "string",
      "minLength": 1,
      "description": "Monitored URL's target ID, from list_competitor_monitors or add_competitor_monitor."
    }
  },
  "required": [
    "projectId",
    "targetId"
  ]
}

get_competitor_monitor_changes

Timeline of DETECTED changes for one monitored competitor URL, newest first — a check that found nothing does not appear here. Each entry's summary is a real diff: line-level content added/removed/unchanged counts with a short sample (never a fabricated similarity score), plus title/meta/status-code before-after values and added/removed external links and structured-data types.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
targetId	string	required	Monitored URL's target ID, from list_competitor_monitors or add_competitor_monitor.
limit	integer	optional	Max entries to return. Defaults to 50, capped at 200.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "targetId": {
      "type": "string",
      "minLength": 1,
      "description": "Monitored URL's target ID, from list_competitor_monitors or add_competitor_monitor."
    },
    "limit": {
      "description": "Max entries to return. Defaults to 50, capped at 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "projectId",
    "targetId"
  ]
}

get_rank_tracker

Read-only access to rank tracker configs and their latest results. With `trackerId`, returns the config plus the latest snapshot per keyword. Without it, lists all trackers in the project. FREE — reads stored MisarSEO state only, runs no SERP query and charges no credits. To trigger a new check, use the dashboard. A null position means THE DOMAIN WAS NOT FOUND WITHIN THE DEPTH SEARCHED. The response states that depth as a number — use THAT number, not the config's `serpDepth`, which is what was asked for and can be several times deeper than the search source reaches. Everything past the depth searched was not measured, so a null is neither a rank of zero nor proof the page stopped ranking — say 'not found in the top N' and give the N the response states. Device columns are printed only where this deployment measures desktop and mobile as separate searches; where it does not, the response says so and prints ONE position per keyword. Never report a mobile or desktop absence from a column the response did not print, and never infer one from the config's `devices` value. `previousPosition` is a roughly 7-day-old comparison point, and when no snapshot that old exists it falls back to the EARLIEST snapshot on record — so a 'was' figure can be much older than a week. Do not quote it as a week-over-week change without checking the tracker's history length.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
trackerId	string	optional	Rank tracker config ID. If omitted, lists all rank trackers in the project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "trackerId": {
      "description": "Rank tracker config ID. If omitted, lists all rank trackers in the project.",
      "type": "string"
    }
  },
  "required": [
    "projectId"
  ]
}

add_rank_tracking_keywords

Adds keywords to an existing rank tracker config. Returns `{ added, addedIds }` — `added` counts only genuinely new keywords; anything already tracked for this config is silently skipped, so `added` can legitimately be lower than the number of keywords sent. FREE: database only, no SEO data provider is called and no credits are spent — but this CAN fail with a plan-limit error if adding these keywords would put the organization over its plan tier's rank-tracked-keywords cap, since that is a count limit, not a spend limit. This does not trigger a rank check or refresh keyword metrics — call get_rank_tracker afterward once you want positions.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID.
keywords	array	required	1-100 keywords to add. Duplicates of already-tracked keywords are silently skipped.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID."
    },
    "keywords": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      },
      "description": "1-100 keywords to add. Duplicates of already-tracked keywords are silently skipped."
    }
  },
  "required": [
    "projectId",
    "configId",
    "keywords"
  ]
}

get_rank_config_trend

Per-run keyword-position-distribution buckets for a tracker, oldest first — how many tracked keywords sit in the top 3, 4-10, 11-20, or outside the top 20, per check run. Use it to answer 'is this domain's visibility trending up or down' without re-checking anything. FREE: database only. No SEO data provider is called and no credits are spent. Buckets are disjoint and cover every tracked keyword: `notRanking` is derived as the remainder, not fetched separately, and `top3 + top4to10 + top11to20 + notRanking` always equals the tracker's keyword count at that run. `device` is accepted but on every free SERP source today it narrows nothing — see get_rank_tracker's own note on this deployment's device support.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
device	string	optional	Which device's positions to bucket. On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.
sinceDays	integer	optional	How many days back to look, 1–730. Defaults to 365.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "device": {
      "description": "Which device's positions to bucket. On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.",
      "type": "string",
      "enum": [
        "desktop",
        "mobile"
      ]
    },
    "sinceDays": {
      "description": "How many days back to look, 1–730. Defaults to 365.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 730
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

get_rank_movers

Newcomers and fast climbers for a tracker's OWN domain, over a window. `newlyRanking` is keywords that started ranking during the window (no earlier position, or an earlier position of null). `fastClimbers` is keywords that ranked at both ends of the window and gained at least `minGain` positions. FREE: database only. No SEO data provider is called and no credits are spent. THIS IS NOT COMPETITOR DISCOVERY. No corpus of undeclared domains exists in this codebase to discover a newcomer domain from — a rank check only ever persists positions for the target domain and the already-tracked competitor list; every other domain in a fetched SERP is read and discarded. Do not describe a `newlyRanking` entry as a 'new competitor' or 'newly discovered domain' — it is a keyword the TRACKED domain itself started ranking for, nothing about a competitor. `newlyRanking` entries always have `gain: null` — there is no earlier position to measure a gain from, and `minGain` never filters them.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
sinceDays	integer	optional	How many days back to look, 1–730. Defaults to 365.
minGain	integer	optional	Positions a keyword must have gained to count as a fast climber, 1–100. Defaults to 5. Does not affect newlyRanking, which has no earlier position to measure a gain from.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "sinceDays": {
      "description": "How many days back to look, 1–730. Defaults to 365.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 730
    },
    "minGain": {
      "description": "Positions a keyword must have gained to count as a fast climber, 1–100. Defaults to 5. Does not affect newlyRanking, which has no earlier position to measure a gain from.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

get_rank_keyword_history

Per-keyword position series over time, oldest first — the same series the app's SERP-history chart draws for one tracked keyword. FREE: database only. No SEO data provider is called and no credits are spent. A `position` of `null` means checked but not found within that check's `searchedDepth` — a real event, not a missing check or a lost ranking. `searchedDepth: null` means the run predates that column, not that any particular depth was searched. At most one point per UTC day: a same-day re-check collapses to its latest reading.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
trackingKeywordId	string	required	The tracked keyword's own row ID (from get_rank_tracker's results), not the keyword text.
sinceDays	integer	optional	How many days back to look, 1–730. Defaults to 365.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "trackingKeywordId": {
      "type": "string",
      "minLength": 1,
      "description": "The tracked keyword's own row ID (from get_rank_tracker's results), not the keyword text."
    },
    "sinceDays": {
      "description": "How many days back to look, 1–730. Defaults to 365.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 730
    }
  },
  "required": [
    "projectId",
    "configId",
    "trackingKeywordId"
  ]
}

get_rank_volatility_index

SERP volatility index across recent runs — how much this tracker's own positions churned run over run, derived entirely from already-stored history (no new SERP calls). FREE: database only, no SEO data provider is called and no credits are spent. Modeled on the one step AccuRanker publicly discloses for their Grump Rating (sum of per-keyword differences / number of results), but CTR-weighted rather than a raw position delta — a #1-#2 swap counts far more than a #18-#19 swap. NOT a 0-10 Sensor score or a mood label (Semrush and MozCast do not publish their formulas, and both are calibrated against panels of hundreds of thousands to millions of keywords spanning the whole web). `volatilityIndex` is meaningful only relative to THIS tracker's own history over time, not as an absolute severity — do not describe a given value as 'high' or 'low' without comparing it to this same tracker's other points.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
device	string	optional	On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.
runLimit	integer	optional	How many recent completed runs to compare consecutively, 2-26. Defaults to 12.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "device": {
      "description": "On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.",
      "type": "string",
      "enum": [
        "desktop",
        "mobile"
      ]
    },
    "runLimit": {
      "description": "How many recent completed runs to compare consecutively, 2-26. Defaults to 12.",
      "type": "integer",
      "minimum": 2,
      "maximum": 26
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

get_rank_ai_overview_trend

AI Overview presence trend across a tracker's keywords, oldest first — what share of tracked keywords showed Google's AI Overview in the SERP, per check run, and how that has moved over time. FREE: database only, no SEO data provider is called and no credits are spent. Reuses `rank_snapshots.serpFeatures`, already populated by the SERP-feature capture the rank checker already does — no new SERP calls. `aiOverviewPresenceRatePct` is `keywordsWithAiOverview / keywordsTotal * 100`, rounded to one decimal, and `null` (not 0) for a run where `keywordsTotal` is 0 — nothing was checked that run, which is a missing measurement, not a truthful "0% presence".

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
device	string	optional	On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.
sinceDays	integer	optional	How many days back to look, 1–730. Defaults to 365.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "device": {
      "description": "On every free SERP source today this narrows nothing — there is no device dimension, so every reading folds to one series regardless of what is passed. Defaults to desktop.",
      "type": "string",
      "enum": [
        "desktop",
        "mobile"
      ]
    },
    "sinceDays": {
      "description": "How many days back to look, 1–730. Defaults to 365.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 730
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

list_rank_annotations

Chart notes on a rank tracker's own timeline — 'deployed new title tags', 'algorithm update' — oldest first. FREE: database only, no SEO data provider is called and no credits are spent. Config-level, not per-keyword or per-device: a deploy or algorithm change is a fact about the date, not about any one reading.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

add_rank_annotation

Adds a chart note to a rank tracker's own timeline. FREE: database only, no SEO data provider is called and no credits are spent. Config-level, not per-keyword or per-device. A config can hold at most 100 notes.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
date	string	required	UTC day the note applies to, YYYY-MM-DD.
label	string	required	What happened, 1-200 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "UTC day the note applies to, YYYY-MM-DD."
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "What happened, 1-200 characters."
    }
  },
  "required": [
    "projectId",
    "configId",
    "date",
    "label"
  ]
}

remove_rank_annotation

Removes a chart note from a rank tracker's own timeline. FREE: database only, no SEO data provider is called and no credits are spent. Succeeds whether or not `id` matched an existing note.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
id	string	required	Note ID, from list_rank_annotations.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Note ID, from list_rank_annotations."
    }
  },
  "required": [
    "projectId",
    "configId",
    "id"
  ]
}

list_rank_cannibalisation

Tracked keywords whose latest ranking URL is not the target URL you declared for them (see set_rank_keyword_target_url). FREE: database only, no SEO data provider is called and no credits are spent. NOT the same detector as get_cannibalisation_report (Search Console-based), which finds two-or-more of the site's OWN pages splitting Search Console impressions for one query. A rank check records only the single best-ranking URL per keyword per run, so this can only tell you the winning page was not the one you intended — not that a second own page also appeared in the SERP.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

set_rank_keyword_target_url

Sets or clears the URL you intend to rank for a tracked keyword. Feeds list_rank_cannibalisation — set this for the keywords you care about, then check for a mismatch after the next run. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
trackingKeywordId	string	required	The tracked keyword's own row ID (from the rank tracker's keyword rows), not the keyword text.
targetUrl	any	required	Absolute http(s) URL you intend to rank for this keyword, or null to clear a previously-set one.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "trackingKeywordId": {
      "type": "string",
      "minLength": 1,
      "description": "The tracked keyword's own row ID (from the rank tracker's keyword rows), not the keyword text."
    },
    "targetUrl": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048
        },
        {
          "type": "null"
        }
      ],
      "description": "Absolute http(s) URL you intend to rank for this keyword, or null to clear a previously-set one."
    }
  },
  "required": [
    "projectId",
    "configId",
    "trackingKeywordId",
    "targetUrl"
  ]
}

list_rank_keyword_tags

Lists the tags in use on one rank tracker, plus the project's whole tag vocabulary. Use it to find tag IDs before calling update_rank_keyword_tag, and to see how a tracker with hundreds of keywords is already organised. FREE: database only. No SEO data provider is called and no credits are spent, so it is safe to call as often as needed. The two lists mean different things and are deliberately separate. `tagsInUse` is what THIS tracker's keywords actually carry, and its `keywordCount` counts TRACKED keywords carrying the tag — not the saved-keyword count the same tag carries elsewhere, which would never match the rows it filters. It is empty for a tracker that has never used a tag. `projectTags` is the project's full vocabulary including tags unused here, so a tag can be reused rather than re-coined. The vocabulary is the project's EXISTING saved-keyword tags: one namespace shared with the saved-keyword list, not a second set.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

update_rank_keyword_tag

Attaches or detaches ONE tag across a selection of tracked keywords (up to 500 keyword IDs per call). One tag per call — applying three tags takes three calls. FREE: database only. No SEO data provider is called and no credits are spent. The tag is the project's EXISTING saved-keyword vocabulary, shared with the saved-keyword list. Pass `tagId` for a tag that already exists (find it with list_rank_keyword_tags), or `tagName` to match on the normalised name. On `action: "add"` an unknown `tagName` CREATES that tag for the whole project, so check the vocabulary first rather than coining near-duplicates; on `action: "remove"` an unknown tag is NOT_FOUND, because there is nothing to detach. DO NOT REPORT `changed` AS A COUNT OF NEW LINKS ON AN ADD. `action: "add"` returns `changed: null` because the insert is idempotent and how many links were actually new is not knowable without a second read — `null` means "not measured". It is not zero, and it is NOT the number of keyword IDs submitted. `action: "remove"` returns a real `changed` count. When asked how many keywords were touched, report `keywordCount`: the tracked keywords the action was applied to, after de-duplication. Both actions return `keywordCount: 0` with `changed: 0` when none of the submitted IDs belong to this tracker — a no-op, not a tagging worth reporting as done.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs.
action	string	required	'add' attaches the tag, creating it from `tagName` when it does not exist yet; 'remove' detaches it.
tagId	string	optional	Existing tag ID from list_rank_keyword_tags. Pass this OR `tagName`, never both.
tagName	string	optional	Tag name, matched on its normalised form — 'Branded', 'branded' and ' branded ' are one tag. Created on 'add' when it does not exist; NOT_FOUND on 'remove'. Pass this OR `tagId`, never both.
trackingKeywordIds	array	required	Tracking-keyword IDs to tag or untag (1–500 per call). These are the rank tracker's own keyword-row IDs — not saved-keyword IDs, and not keyword text. Duplicates are collapsed, and IDs belonging to another tracker are ignored rather than errored.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID. Call get_rank_tracker without a trackerId to list the project's trackers and their IDs."
    },
    "action": {
      "type": "string",
      "enum": [
        "add",
        "remove"
      ],
      "description": "'add' attaches the tag, creating it from `tagName` when it does not exist yet; 'remove' detaches it."
    },
    "tagId": {
      "description": "Existing tag ID from list_rank_keyword_tags. Pass this OR `tagName`, never both.",
      "type": "string",
      "minLength": 1
    },
    "tagName": {
      "description": "Tag name, matched on its normalised form — 'Branded', 'branded' and ' branded ' are one tag. Created on 'add' when it does not exist; NOT_FOUND on 'remove'. Pass this OR `tagId`, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "trackingKeywordIds": {
      "minItems": 1,
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Tracking-keyword IDs to tag or untag (1–500 per call). These are the rank tracker's own keyword-row IDs — not saved-keyword IDs, and not keyword text. Duplicates are collapsed, and IDs belonging to another tracker are ignored rather than errored."
    }
  },
  "required": [
    "projectId",
    "configId",
    "action",
    "trackingKeywordIds"
  ]
}

get_brave_search_rank_check

Checks where a project's domain (or an explicit targetDomain) ranks in REAL Brave Search results for one keyword. Brave has run its own independent crawler and index since 2023 — a genuinely separate, separately-licensed data source, distinct from this server's free SearXNG/openserp-backed rank checks. Every successful response carries engine: 'brave_search' so it can never be mistaken for a free-tier number. PAID: bring-your-own-key — requires the deployment operator to set BRAVE_SEARCH_API_KEY (a single paid credential, like OPENPAGERANK_API_KEY — no OAuth flow). Every call spends that key's Brave Search API budget. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_domain' when neither targetDomain nor the project's own domain is set. Makes exactly one Brave Search API call per check — depth (max 20) is Brave's own per-request ceiling, never paginated to search deeper. Brave publishes no submission/indexing API at all, only manual re-fetch/delist web forms — this tool is query-only.

Parameters7

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keyword	string	required	Keyword to check.
targetDomain	string	optional	Domain or URL to check. Defaults to the project's own domain when omitted.
country	string	optional	2-letter country code Brave uses to target results, e.g. 'US'.
searchLang	string	optional	ISO 639-1 language code Brave uses to filter results, e.g. 'en'.
depth	integer	optional	Results to fetch, 1-20 (Brave's own per-request ceiling). Default 20.
competitorDomains	array	optional	Competitor domains to also resolve positions for, free within the same fetched result set.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "Keyword to check."
    },
    "targetDomain": {
      "description": "Domain or URL to check. Defaults to the project's own domain when omitted.",
      "type": "string",
      "minLength": 1
    },
    "country": {
      "description": "2-letter country code Brave uses to target results, e.g. 'US'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "searchLang": {
      "description": "ISO 639-1 language code Brave uses to filter results, e.g. 'en'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 8
    },
    "depth": {
      "description": "Results to fetch, 1-20 (Brave's own per-request ceiling). Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "competitorDomains": {
      "description": "Competitor domains to also resolve positions for, free within the same fetched result set.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    }
  },
  "required": [
    "projectId",
    "keyword"
  ]
}

create_rank_tracker

Creates a rank tracker config (domain + market + devices + schedule) for a project and returns its configId. Next, add keywords with add_rank_tracking_keywords. Positions are collected by the SCHEDULED check ('daily' or 'weekly'; 'manual' means never on a schedule) and read with get_rank_tracker — nothing here triggers a check on demand. One tracker per (domain, market) per project: repeating a pair is a validation error, not a second tracker. FREE at creation: database only, no credits spent.

Parameters11

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Domain whose positions are tracked, e.g. example.com.
serpDepth	integer	required	How deep to search, 10-100 in steps of 10.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market.
languageCode	string	optional	Language code (e.g. 'en'). Omit it to use the project's default market language.
locationHint	string \| null	optional	Free-text city/region hint, honoured only where the SERP provider supports it.
devices	string	optional	Devices to track.
scheduleInterval	string	optional	How often the scheduled check runs.
rankDropAlertThreshold	integer \| null	optional	Notify when a keyword falls by at least this many positions. null turns it off.
newKeywordAlertEnabled	boolean	optional	Notify when the domain starts ranking for a keyword it did not rank for before.
competitorMoveAlertThreshold	integer \| null	optional	Notify when a tracked competitor gains at least this many positions. null turns it off.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "description": "Domain whose positions are tracked, e.g. example.com."
    },
    "serpDepth": {
      "type": "integer",
      "minimum": 10,
      "maximum": 100,
      "multipleOf": 10,
      "description": "How deep to search, 10-100 in steps of 10."
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market."
    },
    "languageCode": {
      "type": "string",
      "maxLength": 10,
      "description": "Language code (e.g. 'en'). Omit it to use the project's default market language."
    },
    "locationHint": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 200,
      "description": "Free-text city/region hint, honoured only where the SERP provider supports it."
    },
    "devices": {
      "type": "string",
      "enum": [
        "both",
        "desktop",
        "mobile"
      ],
      "description": "Devices to track."
    },
    "scheduleInterval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "manual"
      ],
      "description": "How often the scheduled check runs."
    },
    "rankDropAlertThreshold": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 3,
      "maximum": 100,
      "description": "Notify when a keyword falls by at least this many positions. null turns it off."
    },
    "newKeywordAlertEnabled": {
      "type": "boolean",
      "description": "Notify when the domain starts ranking for a keyword it did not rank for before."
    },
    "competitorMoveAlertThreshold": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 3,
      "maximum": 100,
      "description": "Notify when a tracked competitor gains at least this many positions. null turns it off."
    }
  },
  "required": [
    "projectId",
    "domain",
    "serpDepth"
  ]
}

list_rank_tracking_keywords

Lists the keywords tracked by ONE rank tracker: `{ keywords, totalCount, page, pageSize }`, each row `{ id, configId, keyword, searchVolume, keywordDifficulty, cpc, metricsFetchedAt, createdAt }`. It returns NO positions and runs no check — read positions with get_rank_tracker. The row `id` is the tracking-keyword ID that remove_rank_tracking_keywords, update_rank_keyword_tag and set_rank_keyword_target_url take. FREE: database only.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID.
page	integer	optional	1-based page number. Defaults to 1.
pageSize	integer	optional	Rows per page. Defaults to 50.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based page number. Defaults to 1."
    },
    "pageSize": {
      "type": "integer",
      "enum": [
        50,
        100,
        250
      ],
      "description": "Rows per page. Defaults to 50."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

remove_rank_tracking_keywords

Removes keywords from a rank tracker by their tracking-keyword IDs (from list_rank_tracking_keywords). The keywords stop being checked; their past position snapshots are deliberately kept, so history survives. FREE: database only.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Rank tracker config ID.
keywordIds	array	required	Tracking-keyword IDs to remove.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Rank tracker config ID."
    },
    "keywordIds": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Tracking-keyword IDs to remove."
    }
  },
  "required": [
    "projectId",
    "configId",
    "keywordIds"
  ]
}

start_site_audit

Starts a MisarSEO site crawl/audit from startUrl. Returns `{ jobId, auditId }` (the same id twice) with HTTP 202; the crawl then runs in the background — poll it with get_site_audit_status. FREE of SEO credits, but it CONSUMES ONE of the organization's monthly audits from its plan quota (a spent quota is a plan-limit error), so confirm with the user before starting one and never start one speculatively.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startUrl	string	required	http(s) URL the crawl starts from, usually the site's home page.
maxPages	integer	optional	Most pages to crawl (at most 5000). Omit for the service default of 50.
strategy	string	optional	Which pages get a Lighthouse run. Defaults to auto.
renderJs	boolean	optional	Run each page's JavaScript before analysing it — needed for client-rendered sites. Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startUrl": {
      "type": "string",
      "minLength": 1,
      "description": "http(s) URL the crawl starts from, usually the site's home page."
    },
    "maxPages": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "description": "Most pages to crawl (at most 5000). Omit for the service default of 50."
    },
    "strategy": {
      "type": "string",
      "enum": [
        "auto",
        "all",
        "manual",
        "none"
      ],
      "description": "Which pages get a Lighthouse run. Defaults to auto."
    },
    "renderJs": {
      "type": "boolean",
      "description": "Run each page's JavaScript before analysing it — needed for client-rendered sites. Defaults to false."
    }
  },
  "required": [
    "projectId",
    "startUrl"
  ]
}

get_site_audit_status

Progress of a site audit started by start_site_audit: `{ status, pagesCrawled, pagesTotal, lighthouseTotal, lighthouseCompleted, lighthouseFailed, currentPhase, startedAt, completedAt }`. `status` is 'running', 'completed' or 'failed' — poll until it is 'completed' or 'failed'; there is no 'complete' status, so waiting for that string never ends. It does NOT return crawled pages or individual issues. Once completed, read it with get_audit_comparison, get_audit_core_web_vitals, get_audit_https_report, get_audit_internal_links and get_audit_structured_data. FREE.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	required	The auditId (or jobId — the same value) returned by start_site_audit.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "type": "string",
      "minLength": 1,
      "description": "The auditId (or jobId — the same value) returned by start_site_audit."
    }
  },
  "required": [
    "projectId",
    "auditId"
  ]
}

get_audit_comparison

Compare a site audit against an earlier one: which issues are new, which were fixed, how many persist, and the health-score delta. Only pages BOTH crawls visited are compared, so a shorter crawl never reports the pages it missed as fixed — those are reported separately as notComparableCount. `newIssues` only ever covers an existing page newly showing a finding, never a brand-new page's own findings (those fold into notComparableCount/addedUrlCount instead, since a page neither crawl could compare has no meaningful 'new' vs. 'always there' answer). Returns an error when there is no earlier completed audit to compare against. Free — charges no credits.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	required	Audit ID to compare, from crawl_site or get_crawl_results.
baselineAuditId	string	optional	Audit ID to compare against. OMIT IT unless you have a reason: omitting picks the COMPLETED run immediately before auditId, while a baseline named here is used as given with no completed-status check — pointing it at a failed or still-running crawl diffs against a partial page set. Comparing an audit to itself is a validation error.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "type": "string",
      "minLength": 1,
      "description": "Audit ID to compare, from crawl_site or get_crawl_results."
    },
    "baselineAuditId": {
      "description": "Audit ID to compare against. OMIT IT unless you have a reason: omitting picks the COMPLETED run immediately before auditId, while a baseline named here is used as given with no completed-status check — pointing it at a failed or still-running crawl diffs against a partial page set. Comparing an audit to itself is a validation error.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId",
    "auditId"
  ]
}

get_audit_core_web_vitals

Core Web Vitals report: LCP/INP/CLS per page/strategy this audit already ran Lighthouse against, classified against Google's own published thresholds. No new fetch — reads audit_lighthouse_results, the same table the results UI already renders as raw numbers. LAB DATA ONLY, never Search Console's real Chrome UX Report (CrUX) field data — every number is a single simulated Lighthouse run, not an aggregated real-user measurement. This codebase's audit pipeline runs local headless Chrome as its PRIMARY path, so CrUX field data is not reliably available for any given page. ALWAYS narrow on `state` first: `no_lighthouse_data` (this audit has no Lighthouse rows at all — an absence of data, NOT every page passing) or `analysed`. Errors when no audit with that id belongs to the project. `pages[].allGood` is true only when all three metrics were measured AND all three are "good". Free — charges no credits.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	required	Audit ID, from crawl_site or get_crawl_results.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "type": "string",
      "minLength": 1,
      "description": "Audit ID, from crawl_site or get_crawl_results."
    }
  },
  "required": [
    "projectId",
    "auditId"
  ]
}

get_audit_https_report

HTTPS Report: percentage of pages secure, mixed-content and insecure-link counts, homepage HTTPS-path status, and HTTP URLs in an HTTPS site's sitemap — for a project's latest completed crawl (or a named earlier one). Derives entirely from already-computed crawl data — no new work at read time. SOCKET-LEVEL TLS CHECKS STAY EXPLICITLY UNBUILT: expiring/expired certificate, old security protocol, incorrect certificate name, and subdomains without SNI/HSTS all need a real TLS handshake this fetch-based crawler does not make. `notDerivable` lists these with the reason. `homepageStatus.redirectsToHttps` is null (not measured), never assumed healthy, unless a standalone fetch actually observed a failure — this report cannot distinguish "checked and fine" from "never checked" from stored issue rows alone. ALWAYS narrow on `state` first: `no_audit` (no completed crawl yet), `analysed`. Free — charges no credits, makes no external call.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	optional	Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "description": "Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId"
  ]
}

get_audit_internal_links

Internal Link Report: outbound/inbound internal link counts per page, orphan pages, dead ends, and click-depth distribution for a project's latest completed crawl (or a named earlier one). No new computation — reads the same audit_pages/audit_issues columns already powering the in-app internal-links page. INTERNAL LINKS ONLY. External links are explicitly out of scope: an external link graph needs data this codebase does not collect. `totals.externalLinkOccurrences` is the one external-facing number here — a raw per-page outbound tally, never a graph. ALWAYS narrow on `state` first: `no_audit` (no completed crawl yet), `signal_not_captured` (a crawl exists but its link counts predate the inbound-link/click-depth migration or were otherwise never computed — an absence of data, NOT a site with no internal links), `analysed`. `notDerivable` is returned with every state and lists what this report can never compute from what is stored, and why. Free — charges no credits, makes no external call.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	optional	Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "description": "Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId"
  ]
}

get_audit_structured_data

Structured Data Report: pages grouped by schema.org @type, which pages have none, and which pages carry an unparseable JSON-LD block — for a project's latest completed crawl (or a named earlier one). Derives entirely from structured data already extracted at crawl time — no new crawl-time work. PRESENCE AND PARSE VALIDITY, NOT A RICH-RESULTS ELIGIBILITY CHECK. Only `typeGroups[].invalidCount` on the BreadcrumbList group is a real, verified per-type validity verdict; every other type reports only whether pages declare it and whether ANY block on the page failed to parse (page-level — never attributable to one type when a page declares several). ALWAYS narrow on `state` first: `no_audit` (no completed crawl yet), `analysed` (`typeGroups: []` means every page was measured and none declared any structured data — a real finding, not a withheld section). `notDerivable` lists what this report can never compute, and why. Free — charges no credits, makes no external call.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
auditId	string	optional	Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "auditId": {
      "description": "Audit ID, from crawl_site or get_crawl_results. Omitted means the latest completed audit for this project.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId"
  ]
}

get_search_console_performance

Query the connected Search Console property's Search Analytics: clicks, impressions, CTR, and average position by query/page/country/device/date. First-party data — use it for what already ranks, near-ranking queries, and pages with real demand. ctr is a 0-1 fraction; position is a 1-based average; dates are Pacific Time; the last ~3 days may be incomplete. Read-only and FREE (no credits) — Search Console is first-party data and meters nothing. It does spend Google's per-property request quota. Google omits rows it will not disclose (anonymised queries) and returns at most `rowLimit` of the rest, so what it withholds is not measured rather than absent: zero rows is not zero demand, and a total summed from these rows is a floor, never the property's real total. When `hasMore` is true you have seen only part of the match set — page with `startRow` before reporting any sum or count as complete.

Parameters10

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
dimensions	array	optional	Group rows by these dimensions. Default ['query']. Use ['page'] for top pages, ['query','page'] to map queries to pages / spot cannibalization, ['date'] for a time series.
dateRange	string	optional	Convenience window (default last_28_days). End is set ~3 days back for GSC data lag. Ignored if startDate+endDate are given. Max lookback is 16 months.
startDate	string	optional	Explicit start (YYYY-MM-DD, Pacific Time). Use with endDate.
endDate	string	optional	Explicit end (YYYY-MM-DD, Pacific Time). Use with startDate.
filters	array	optional	AND-combined filters. To get the queries for one page: [{dimension:'page',operator:'equals',expression:'https://example.com/post'}] with dimensions ['query'].
rowLimit	integer	optional	Rows per call (default 1000, max 1000). GSC sorts by clicks desc and can't filter by position — filter 'striking distance' positions client-side, and paginate with startRow when hasMore is true.
startRow	integer	optional	Pagination offset.
type	string	optional	Search type (default web).
dataState	string	optional	'all' (default) includes fresh/incomplete recent data.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "dimensions": {
      "description": "Group rows by these dimensions. Default ['query']. Use ['page'] for top pages, ['query','page'] to map queries to pages / spot cannibalization, ['date'] for a time series.",
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "query",
          "page",
          "country",
          "device",
          "date",
          "searchAppearance",
          "hour"
        ]
      }
    },
    "dateRange": {
      "description": "Convenience window (default last_28_days). End is set ~3 days back for GSC data lag. Ignored if startDate+endDate are given. Max lookback is 16 months.",
      "type": "string",
      "enum": [
        "last_7_days",
        "last_28_days",
        "last_3_months",
        "last_6_months",
        "last_12_months",
        "last_16_months"
      ]
    },
    "startDate": {
      "description": "Explicit start (YYYY-MM-DD, Pacific Time). Use with endDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "endDate": {
      "description": "Explicit end (YYYY-MM-DD, Pacific Time). Use with startDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "filters": {
      "description": "AND-combined filters. To get the queries for one page: [{dimension:'page',operator:'equals',expression:'https://example.com/post'}] with dimensions ['query'].",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dimension": {
            "type": "string",
            "enum": [
              "query",
              "page",
              "country",
              "device",
              "date",
              "searchAppearance",
              "hour"
            ]
          },
          "operator": {
            "default": "equals",
            "type": "string",
            "enum": [
              "equals",
              "notEquals",
              "contains",
              "notContains"
            ]
          },
          "expression": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "dimension",
          "expression"
        ]
      }
    },
    "rowLimit": {
      "description": "Rows per call (default 1000, max 1000). GSC sorts by clicks desc and can't filter by position — filter 'striking distance' positions client-side, and paginate with startRow when hasMore is true.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "startRow": {
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0
    },
    "type": {
      "description": "Search type (default web).",
      "type": "string",
      "enum": [
        "web",
        "image",
        "video",
        "news",
        "googleNews",
        "discover"
      ]
    },
    "dataState": {
      "description": "'all' (default) includes fresh/incomplete recent data.",
      "type": "string",
      "enum": [
        "all",
        "final"
      ]
    }
  },
  "required": [
    "projectId"
  ]
}

inspect_urls

Run Google Search Console's URL Inspection on up to 10 URLs of the connected property: index/coverage state, last crawl time, Google-selected vs declared canonical, and mobile/rich-results verdicts. Use it to answer 'is this page indexed? why not?'. Read-only and FREE (no credits) — Search Console is first-party data and meters nothing. Every submitted URL comes back as a row, but a row carrying `error` was NOT inspected: Google refused or failed on it, so its index state was not measured rather than found to be bad. Count the rows without an `error` when saying how many URLs you checked. A verdict of UNKNOWN is Google's own 'no determination', not a page that is missing from the index.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
urls	array	required	1–10 absolute URLs to inspect. Each must belong to the connected property.
languageCode	string	optional	BCP-47 language for the inspection result (e.g. 'en-US').

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "urls": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "description": "1–10 absolute URLs to inspect. Each must belong to the connected property."
    },
    "languageCode": {
      "description": "BCP-47 language for the inspection result (e.g. 'en-US').",
      "type": "string"
    }
  },
  "required": [
    "projectId",
    "urls"
  ]
}

get_search_console_coverage

MisarSEO's own index-coverage report for the connected property: which URLs are indexed, excluded, or errored, and why. FREE (no credits) and makes NO call to Google — unlike get_search_console_performance, this reads `gscUrlCoverage`, populated by a nightly scan built on the URL Inspection API's ~2000/day quota, so coverage fills in over days rather than in one pass. `summary` is the headline count per coverageState. `rows` is one page (default 200, max 1000) of the URLs themselves, newest-inspected first — filter to one state with `coverageState`. An empty summary/rows with ok: true means the nightly scan has not populated this property yet, not that every page is fine.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
coverageState	string	optional	Filter to one state, e.g. "Submitted and indexed". Free text, matching Google's own strings verbatim.
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "coverageState": {
      "description": "Filter to one state, e.g. \"Submitted and indexed\". Free text, matching Google's own strings verbatim.",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "projectId"
  ]
}

get_search_console_hourly_performance

MisarSEO's own retained HOURLY Search Console totals for the connected property — the hourly counterpart to get_search_console_performance's daily archive. FREE (no credits) and makes NO call to Google: reads MisarSEO's own Postgres. Unlike the daily archive, a wider date range does not mean more history — Google itself only offers roughly the trailing 8-10 days of hourly data, and the nightly sync only ever fetches that same window, so a startDate earlier than it simply returns nothing for the days outside it. Each row's `hour` is 0-23 in Search Console's own America/Los_Angeles reporting hour.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_search_console_sitemaps

Search Console sitemaps.list/sitemaps.get: every sitemap submitted for the connected property and its processing status (pending, last downloaded, warning/error counts, per-content-type submitted counts), or one named sitemap. Read-only — needs only the `webmasters.readonly` scope this deployment's Search Console connection already requests. Submit/delete need the broader `webmasters` scope and are deliberately not offered. Free (no credits) but spends one call of Google's per-property quota. Omit `feedpath` to list every sitemap; pass one (a sitemap's own URL) to fetch just that one instead — either way the response is `sitemaps`, a one-entry array for `feedpath`. `lastSubmitted`/`lastDownloaded`/`warnings`/`errors` are absent, not zero, when Google has nothing to report for that field.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
feedpath	string	optional	A specific sitemap's own URL (e.g. another entry's own `path`). Omitted lists every sitemap Search Console has on record for the property.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "feedpath": {
      "description": "A specific sitemap's own URL (e.g. another entry's own `path`). Omitted lists every sitemap Search Console has on record for the property.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId"
  ]
}

get_gsc_ctr_by_position

CTR by ranking position: the site's own historical Search Console clicks/impressions bucketed by position (1-3, 4-10, 11-20, 21+ — mirroring this codebase's existing rank-tracking position-distribution buckets), with the REAL clicks-weighted CTR this project achieved at each bucket. NEVER a fabricated industry-average CTR curve (the generic 'position 1 gets X% CTR' tables third-party vendors publish) — every figure is computed from this project's own archived Search Console history. Free and makes NO live Google call: reads only the archive `get_content_decay_report` also reads. ALWAYS narrow on `state` first: `not_connected` (connect a property), `no_data` (a property is bound but the archive has no rows at all for this dimension/window — an absence of data, NOT zero traffic), `analysed`.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
dimension	string	optional	Bucket by query or page position (default 'query').
dateRange	string	optional	Convenience window over MisarSEO's own archive (default 'last_28_days'). No Google clamp applies — this never calls Google.
startDate	string	optional	Explicit start date (YYYY-MM-DD). Use with endDate.
endDate	string	optional	Explicit end date (YYYY-MM-DD). Use with startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "dimension": {
      "description": "Bucket by query or page position (default 'query').",
      "type": "string",
      "enum": [
        "query",
        "page"
      ]
    },
    "dateRange": {
      "description": "Convenience window over MisarSEO's own archive (default 'last_28_days'). No Google clamp applies — this never calls Google.",
      "type": "string",
      "enum": [
        "last_7_days",
        "last_28_days",
        "last_3_months",
        "last_6_months",
        "last_12_months",
        "last_16_months"
      ]
    },
    "startDate": {
      "description": "Explicit start date (YYYY-MM-DD). Use with endDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "endDate": {
      "description": "Explicit end date (YYYY-MM-DD). Use with startDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "projectId"
  ]
}

get_gsc_anonymous_queries

Anonymized-query estimate: Search Console omits some rare queries entirely from a query-dimensioned response to protect searcher privacy (Google's own documented behaviour, not this codebase's assumption). This compares the SUM of named per-query clicks/impressions against the property's TRUE undimensioned total for the same window — the gap is a real, derived anonymized-query volume. Charges no credits but spends TWO Search Console requests of Google's per-property quota per call. ALWAYS narrow on `state` first: `not_connected`, `requires_reconnect` (the bound property's Google grant can no longer be used), `no_search_data` (Search Console returned nothing for the window — an absence of data, NOT zero anonymization), `analysed`. On `analysed`, ALWAYS check `possiblyRowCapped`: when true, part of the gap is queries the 1,000-row named-query fetch did not reach, not privacy anonymization — the estimate then overstates true anonymization.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
dateRange	string	optional	Convenience window (default 'last_28_days'). This DOES call Google, so Search Console's usual ~16-month clamp and ~3-day data lag both apply.
startDate	string	optional	Explicit start date (YYYY-MM-DD). Use with endDate.
endDate	string	optional	Explicit end date (YYYY-MM-DD). Use with startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "dateRange": {
      "description": "Convenience window (default 'last_28_days'). This DOES call Google, so Search Console's usual ~16-month clamp and ~3-day data lag both apply.",
      "type": "string",
      "enum": [
        "last_7_days",
        "last_28_days",
        "last_3_months",
        "last_6_months",
        "last_12_months",
        "last_16_months"
      ]
    },
    "startDate": {
      "description": "Explicit start date (YYYY-MM-DD). Use with endDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "endDate": {
      "description": "Explicit end date (YYYY-MM-DD). Use with startDate.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "projectId"
  ]
}

get_cannibalisation_report

Finds the queries where the project's connected Search Console property competes with itself: two or more of its own pages drawing impressions for the same query, splitting that query's clicks, click signals and ranking history across URLs. Read-only and FREE (no credits) — Search Console is first-party data and meters nothing. It does spend Google's per-property request quota, so it is rate limited per user. Requires Search Console to be connected for the project. Returns exactly ONE of four states, which are four different facts — branch on `state` before reading anything else: `not_connected` (nothing is bound; tell the user to connect a property), `requires_reconnect` (bound but the Google grant is revoked/expired; tell the user to reconnect), `no_search_data` (Search Console returned nothing for the window — an absence of data, NOT a clean bill of health), `analysed` (we looked; `findings` may legitimately be empty and `coverage` is the proof, including `truncated` when the property had more rows than one report can fetch). In each of the first three states nothing was measured at all, so never report any of them as 'no cannibalisation found'. Every per-page figure is Search Console's own for that (query, page) pair — ctr is a 0-1 fraction, position is a 1-based average, dates are Pacific Time and the last ~3 days are excluded for data lag. `thresholds` ships with each analysed report so you can say whether a threshold, rather than the absence of a problem, is why a query is missing.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
window	string	optional	Analysis window (default last_28_days). Capped at three months on purpose — Search Console's longer ranges are NOT offered, because over a long window 'two pages received impressions' also describes a page migration, and calling that cannibalisation sends someone to consolidate pages that are already consolidated. The window end is backed off ~3 days for Search Console's data lag.
sort	string	optional	Finding order (default impressions). 'impressions' = most affected search demand first. 'position_spread' = smallest gap between the competing pages' average positions first, i.e. the pages Google rated most interchangeable. Both order by one measured quantity; there is deliberately no composite severity score.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "window": {
      "description": "Analysis window (default last_28_days). Capped at three months on purpose — Search Console's longer ranges are NOT offered, because over a long window 'two pages received impressions' also describes a page migration, and calling that cannibalisation sends someone to consolidate pages that are already consolidated. The window end is backed off ~3 days for Search Console's data lag.",
      "type": "string",
      "enum": [
        "last_7_days",
        "last_28_days",
        "last_3_months"
      ]
    },
    "sort": {
      "description": "Finding order (default impressions). 'impressions' = most affected search demand first. 'position_spread' = smallest gap between the competing pages' average positions first, i.e. the pages Google rated most interchangeable. Both order by one measured quantity; there is deliberately no composite severity score.",
      "type": "string",
      "enum": [
        "impressions",
        "position_spread"
      ]
    }
  },
  "required": [
    "projectId"
  ]
}

get_content_decay_report

Finds pages whose clicks declined by a meaningful amount between two adjacent windows, read entirely from MisarSEO's own archived Search Console history (the top-200-per-day per-page archive the nightly sync fills in). Read-only and FREE (no credits), and makes NO live Search Console call — unlike get_cannibalisation_report, this spends no Google quota, so it is rate limited only against ordinary abuse. Requires Search Console to be connected for the project. Returns exactly ONE of three states, which are three different facts — branch on `state` before reading anything else: `not_connected` (nothing is bound; tell the user to connect a property), `insufficient_history` (bound, but one of the two comparison windows has no archived rows at all — an absence of data, NOT a clean bill of health), `analysed` (we looked; `findings` may legitimately be empty and `coverage` is the proof). In both of the first two states nothing was measured, so never report either as 'no content decay found'. `window` selects the RECENT period length; the EARLIER period compared against it is the same length immediately before it, not a calendar-month split. `minEarlierClicks` (default 10) and `declineThresholdPct` (default 20) are this codebase's own chosen defaults, not a published vendor formula. A page that fell out of the archive's top-200-per-day entirely reports `recentClicks: 0` — correctly the most severe decay, not a data hole.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
window	string	optional	The RECENT period length (default last_28_days). The EARLIER period compared against it is the same length immediately before it — a period-over-period comparison, not a calendar-month split.
minEarlierClicks	integer	optional	A page must have had at least this many clicks in the earlier window to be considered at all (default 10) — a noise floor, not part of the decay definition.
declineThresholdPct	integer	optional	How big a decline (percent) is required to be reported (default 20). 0 disables reporting entirely.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "window": {
      "description": "The RECENT period length (default last_28_days). The EARLIER period compared against it is the same length immediately before it — a period-over-period comparison, not a calendar-month split.",
      "type": "string",
      "enum": [
        "last_28_days",
        "last_90_days"
      ]
    },
    "minEarlierClicks": {
      "description": "A page must have had at least this many clicks in the earlier window to be considered at all (default 10) — a noise floor, not part of the decay definition.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "declineThresholdPct": {
      "description": "How big a decline (percent) is required to be reported (default 20). 0 disables reporting entirely.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "projectId"
  ]
}

get_backlinks_overview

Returns a backlinks profile summary (total backlinks, referring domains, referring pages, rank) plus the top referring domains by backlink count. CHARGES CREDITS ON THE PAID DATA PROVIDER (~200-500 typical): two lookups per call, the summary and one page of referring domains. UNAVAILABLE ON THE DEFAULT FREE DATA PROVIDER: a backlink graph needs a proprietary web-scale crawl index, so every method of this surface throws SEO_DATA_UNAVAILABLE there and nothing is charged. That error means the question was never asked — never report it as a site with no backlinks. Self-hosted deployments also need the Backlinks API enabled on their DataForSEO account. The two halves count DIFFERENT populations: the summary totals are unfiltered, while the referring-domain list has domains above the spam-score threshold filtered out. Do not present the listed domains as the top slice of the summary total, and do not subtract one from the other.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
target	string	required	Domain or URL to analyze (e.g. 'example.com' or 'https://example.com/blog').
scope	string	optional	'domain' analyzes the whole domain; 'page' analyzes a specific URL. Defaults to 'domain'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Domain or URL to analyze (e.g. 'example.com' or 'https://example.com/blog')."
    },
    "scope": {
      "description": "'domain' analyzes the whole domain; 'page' analyzes a specific URL. Defaults to 'domain'.",
      "type": "string",
      "enum": [
        "domain",
        "page"
      ]
    }
  },
  "required": [
    "projectId",
    "target"
  ]
}

get_link_intersect

Finds the domains that link to 2–4 of the project's competitors but NOT to the project itself. Every row is a site that has already demonstrated it will link to something in this space, which is what makes it the most actionable backlink report there is. CHARGES CREDITS — the most expensive call in the backlinks surface: one referring-domains lookup per request, 5 of them paging the project's OWN referring domains plus 1 per competitor, so one run costs up to 9 upstream requests of 1000 domains each. Every request is cached per organization+target+page, so re-running the same intersect with a different threshold, proof filter or sort is FREE — do that rather than issuing a new run, and confirm with the user before sweeping several competitor sets. UNAVAILABLE ON THE FREE DATA PROVIDER: a backlink graph needs a proprietary web-scale crawl index, so a deployment on the free provider answers with `unavailable: true`, a reason, and no rows. `totalRows`, `provenRows` and `unprovenRows` are 0 on that response and are NOT measurements — they travel beside the flag precisely so an empty table is never read as an answer. Check `unavailable` before `rows`, and never report an unavailable run as 'no opportunities exist'. `absence` has two states that must NOT be conflated. `proven` means our own referring-domain read ruled the domain out, so "does not link to us" is a measurement. `unproven` means our read was cut off at or above that domain's authority, so it may already link to us and nothing was established — never present an `unproven` row as a confirmed opportunity. `provenRows` is the headline count and excludes them by construction. `absenceBound` says which regime applies: `complete` (our whole profile was read) or `authority-floor` with the `authorityFloor` strictly above which absence is evidence. `coverage[]` is the per-target ledger — `domainsRead`, the provider's `domainsTotal`, `requestsSpent`/`requestBudget`, `truncated`, `authorityFloor`, and a per-target `unavailable`/`unavailableReason`. A competitor cell's `found: false` only means 'does not link to them' when that competitor's coverage is not `truncated`. The project's own domain is read from the project record and cannot be passed in — if the project has no domain the call fails with a validation error telling the user to set one. `minCompetitors` is clamped to the number of competitor domains that actually resolved (duplicates and the project's own domain are dropped); compare it with `minCompetitorsRequested` before calling a run empty. At most 200 rows are returned; `totalRows` is the real match count. There is deliberately no composite opportunity score and no subdomain toggle.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
competitorDomains	array	required	2–4 competitor domains (bare domain or full URL). Each one is a separate billable referring-domains lookup, so pick the rivals actually being chased. 2 is the floor because with a single competitor this degenerates into a one-sided referring-domain diff, not an intersect. The project's own domain is added automatically and is dropped from this list if it appears here.
minCompetitors	integer	optional	Keep only domains linking to at least this many of the compared competitors. Defaults to 2, and is clamped to the number of competitors that actually resolved — compare `minCompetitors` against `minCompetitorsRequested` on the result before calling a run empty.
includeUnproven	boolean	optional	Include rows whose absence from our own profile could not be proven. Defaults to true — leave it true: unproven rows are labelled rather than hidden, and excluding them silently drops real candidates.
sortField	string	optional	Sort column: 'competitors' (default), 'authority' or 'linkingPages'. All three are values the provider measured — there is deliberately no composite opportunity score. Re-sorting a run reuses the cached lookups and costs nothing.
sortOrder	string	optional	Sort direction. Defaults to 'desc'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "competitorDomains": {
      "minItems": 2,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "2–4 competitor domains (bare domain or full URL). Each one is a separate billable referring-domains lookup, so pick the rivals actually being chased. 2 is the floor because with a single competitor this degenerates into a one-sided referring-domain diff, not an intersect. The project's own domain is added automatically and is dropped from this list if it appears here."
    },
    "minCompetitors": {
      "description": "Keep only domains linking to at least this many of the compared competitors. Defaults to 2, and is clamped to the number of competitors that actually resolved — compare `minCompetitors` against `minCompetitorsRequested` on the result before calling a run empty.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "includeUnproven": {
      "description": "Include rows whose absence from our own profile could not be proven. Defaults to true — leave it true: unproven rows are labelled rather than hidden, and excluding them silently drops real candidates.",
      "type": "boolean"
    },
    "sortField": {
      "description": "Sort column: 'competitors' (default), 'authority' or 'linkingPages'. All three are values the provider measured — there is deliberately no composite opportunity score. Re-sorting a run reuses the cached lookups and costs nothing.",
      "type": "string",
      "enum": [
        "competitors",
        "authority",
        "linkingPages"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Defaults to 'desc'.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "projectId",
    "competitorDomains"
  ]
}

list_disavow_entries

Disavow file management: every disavow entry for a project, oldest first. FREE (no credits). Use export_disavow_file to get the actual Google-format .txt content.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

add_disavow_entry

Disavow file management: mark one URL or domain for disavowal. FREE (no credits), but this is a MUTATION. entryType 'url' disavows exactly that page (value must be a full absolute URL); entryType 'domain' disavows the whole domain AND its subdomains (value is a bare host, no scheme) — per Google's own documented disavow-file format, there is no way to disavow just a subpath.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
entryType	string	required	'url' disavows one page; 'domain' disavows the whole domain and its subdomains.
value	string	required	A full absolute URL for entryType 'url'; a bare domain (no scheme) for entryType 'domain'.
note	string	optional	Optional reason, written as a comment above the entry in the exported file.
source	string	optional	Where this entry came from. Defaults to 'manual'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "entryType": {
      "type": "string",
      "enum": [
        "url",
        "domain"
      ],
      "description": "'url' disavows one page; 'domain' disavows the whole domain and its subdomains."
    },
    "value": {
      "type": "string",
      "minLength": 1,
      "description": "A full absolute URL for entryType 'url'; a bare domain (no scheme) for entryType 'domain'."
    },
    "note": {
      "description": "Optional reason, written as a comment above the entry in the exported file.",
      "type": "string",
      "maxLength": 500
    },
    "source": {
      "description": "Where this entry came from. Defaults to 'manual'.",
      "type": "string",
      "enum": [
        "manual",
        "bing_own_site"
      ]
    }
  },
  "required": [
    "projectId",
    "entryType",
    "value"
  ]
}

remove_disavow_entry

Disavow file management: remove one disavow entry by id (from list_disavow_entries). FREE (no credits), but this is a MUTATION. Succeeds whether or not entryId existed.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
entryId	string	required	Entry id, from list_disavow_entries.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "entryId": {
      "type": "string",
      "minLength": 1,
      "description": "Entry id, from list_disavow_entries."
    }
  },
  "required": [
    "projectId",
    "entryId"
  ]
}

export_disavow_file

Disavow file management: export a project's disavow entries as the exact .txt content Google's disavow tool accepts (support.google.com/webmasters/answer/2648487) — one bare URL per line to disavow that exact page, or `domain:<host>` to disavow an entire domain and its subdomains. FREE (no credits). Save `fileContent` to a .txt file as-is (UTF-8).

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_backlink_anchors

Anchor-text distribution for a domain or URL, one page at a time: which anchor texts link to it, with backlinks, referring domains, referring pages and dofollow links per anchor. This is what reveals an over-optimised profile (one exact-match commercial phrase dominating) or a hacked one (pharma/casino anchors nobody wrote) — both invisible link by link. CHARGES CREDITS ON THE PAID DATA PROVIDER (~200-500 typical). UNAVAILABLE ON THE DEFAULT FREE DATA PROVIDER, like the rest of the backlinks surface: SEO_DATA_UNAVAILABLE there means the question was never asked, never an empty distribution. There is deliberately no spam-score column — an averaged spam score is not a spam score.

Parameters7

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
target	string	required	Domain or URL whose inbound anchor texts to list.
scope	string	optional	Whether target is a whole domain or one page. Defaults to domain.
page	integer	optional	1-based page number. Defaults to 1.
pageSize	integer	optional	Rows per page. Defaults to 100.
sortField	string	optional	Sort column. Defaults to backlinks.
sortOrder	string	optional	Sort direction. Defaults to desc.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "target": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Domain or URL whose inbound anchor texts to list."
    },
    "scope": {
      "type": "string",
      "enum": [
        "domain",
        "page"
      ],
      "description": "Whether target is a whole domain or one page. Defaults to domain."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-based page number. Defaults to 1."
    },
    "pageSize": {
      "type": "integer",
      "enum": [
        50,
        100,
        200
      ],
      "description": "Rows per page. Defaults to 100."
    },
    "sortField": {
      "type": "string",
      "enum": [
        "anchor",
        "backlinks",
        "referringDomains",
        "referringPages",
        "dofollow",
        "firstSeen"
      ],
      "description": "Sort column. Defaults to backlinks."
    },
    "sortOrder": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction. Defaults to desc."
    }
  },
  "required": [
    "projectId",
    "target"
  ]
}

get_content_optimizer_report

On-page recommendations and an AI content grade for one page, benchmarked against the pages currently ranking for its target keyword, built together — one AI-gateway call produces both the grade and the recommendations). CHARGES ONE AI-gateway operation against the organization's shared monthly ceiling — not a plan-quota dimension of its own. The page crawl (target + up to 5 competitors) and the SERP fetch are both free. `url` does not have to belong to the project's own domain or to a page a site audit has crawled — any http(s) URL is graded fresh. ALWAYS narrow on `state` first: `target_unreachable` means the target page itself could not be fetched — an ordinary outcome, never treat it as 'this page scored zero'. `analysed` carries the full report; check `coverage.serpUnavailable` and `competitorsCrawled` before trusting the competitor comparison. `grade` is an AI-generated qualitative read of the measured signals, NOT a calibrated industry score. Does NOT detect AI-written content — that is not built; no reliable free technique exists for it.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	The page to grade (any http(s) URL).
keyword	string	required	The keyword this page is meant to rank for.
locationCode	integer	optional	Numeric location code. Defaults to the project's stored market, else 2840 (United States).
languageCode	string	optional	Language code. Defaults to the project's stored market, else 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The page to grade (any http(s) URL)."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The keyword this page is meant to rank for."
    },
    "locationCode": {
      "description": "Numeric location code. Defaults to the project's stored market, else 2840 (United States).",
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "languageCode": {
      "description": "Language code. Defaults to the project's stored market, else 'en'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 8
    }
  },
  "required": [
    "projectId",
    "url",
    "keyword"
  ]
}

get_content_page_metrics

Lightweight on-page metrics for one arbitrary URL — the content optimizer's keyword-free, AI-free sibling. Built for ambient per-page checks (e.g. the browser extension's on-page panel checking whatever page the user is currently viewing) with none of `get_content_optimizer_report`'s cost: no keyword required, no AI-gateway charge, no competitor crawl or SERP fetch. `url` does not have to belong to the project's own domain — any http(s) URL is analyzed fresh. ALWAYS narrow on `state` first: `unreachable` means the page itself could not be fetched — an ordinary outcome for an arbitrary URL check, never treat it as an error.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	The page to analyze (any http(s) URL).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The page to analyze (any http(s) URL)."
    }
  },
  "required": [
    "projectId",
    "url"
  ]
}

run_brand_radar_scan

Scans real AI-answer engines and search citations for brand mentions, Share of Voice against named competitors, and cited sources. REQUIRES A PAID PLAN — a free-tier organization gets a plan-locked error, not an empty result — and CONSUMES ONE of the organization's monthly Brand Radar scan allowance PLUS one shared AI-gateway operation, both charged BEFORE the scan runs. The allowance is spent when the scan is ACCEPTED, before any answer exists — every call submits a new scan, so ask before re-running one. The scan runs on a background queue: this tool waits up to ~45 seconds for it and returns the result when it completes; if it is still running it returns the `jobId` instead — collect the result with get_brand_radar_scan_status (free to poll) rather than calling this tool again, which would spend another scan. Mentions and AI search volumes are nullable: a null is 'not reported by the platform', never 0.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
brand	string	required	Brand, domain, or product name to scan.
competitors	array	optional	Up to 5 competitor brands/domains to compare Share of Voice against.
locationCode	integer	optional	DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Brand, domain, or product name to scan."
    },
    "competitors": {
      "description": "Up to 5 competitor brands/domains to compare Share of Voice against.",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 250
      }
    },
    "locationCode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "DataForSEO location code. Omit it to use the project's default market, which falls back to 2840 (United States) for a project that has not set one. See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "brand"
  ]
}

get_brand_radar_scan_status

Status of a Brand Radar scan started by run_brand_radar_scan, by its `jobId`. `status` is queued/running/complete/errored; a complete scan carries the shaped `result` (share of voice, top cited pages, top prompts), an errored one carries `error.message`. FREE to poll: a completed scan re-reads the cached result and charges nothing. The one exception is a scan whose cached result has already expired (older than ~24h) — answering that re-runs the lookup and is charged and rate limited like a new scan, so collect results promptly. Use this instead of re-running run_brand_radar_scan, which always spends another monthly scan.

Parameters2

projectId	string	required	Required. The MisarSEO project ID the scan was run for.
jobId	string	required	The `jobId` returned by run_brand_radar_scan.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID the scan was run for."
    },
    "jobId": {
      "type": "string",
      "minLength": 1,
      "description": "The `jobId` returned by run_brand_radar_scan."
    }
  },
  "required": [
    "projectId",
    "jobId"
  ]
}

explore_ai_prompt

Runs one prompt through up to 4 model personas and returns each answer verbatim, with real citations when webSearch is on. The four persona labels (chat_gpt/claude/gemini/perplexity) are NOT vendor-verified — none is guaranteed to be that vendor's own model; 'claude' and 'perplexity' in particular have no real vendor route at all. Treat every answer as 'a model answering as X', never as ground truth from X. REQUIRES A PAID PLAN and CHARGES one shared AI-gateway operation per call (not per model) — plus one more if analyzeSentiment and highlightBrand are BOTH set.

Parameters7

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prompt	string	required	The prompt to send to each requested model.
models	array	required	1-4 model personas to answer the prompt (chat_gpt, claude, gemini, perplexity). See this tool's own description for what these labels do and do not guarantee.
highlightBrand	string	optional	A brand/entity name to highlight mentions of in each answer. Required for analyzeSentiment.
webSearch	boolean	optional	Ground the answer in a real retrieval pass with cited sources, shared across every requested persona. Defaults to true.
webSearchCountryCode	string	optional
analyzeSentiment	boolean	optional	Classify sentiment toward highlightBrand in each answer. Requires highlightBrand. Spends one EXTRA AI-gateway operation on top of the base call — never charged unless both this and highlightBrand are set.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The prompt to send to each requested model."
    },
    "models": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "chat_gpt",
          "claude",
          "gemini",
          "perplexity"
        ]
      },
      "description": "1-4 model personas to answer the prompt (chat_gpt, claude, gemini, perplexity). See this tool's own description for what these labels do and do not guarantee."
    },
    "highlightBrand": {
      "description": "A brand/entity name to highlight mentions of in each answer. Required for analyzeSentiment.",
      "type": "string",
      "minLength": 1,
      "maxLength": 250
    },
    "webSearch": {
      "description": "Ground the answer in a real retrieval pass with cited sources, shared across every requested persona. Defaults to true.",
      "type": "boolean"
    },
    "webSearchCountryCode": {
      "type": "string",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "IE",
        "DE",
        "FR",
        "ES",
        "IT",
        "NL",
        "PT",
        "PL",
        "SE",
        "NO",
        "DK",
        "BR",
        "MX",
        "IN",
        "JP",
        "KR",
        "SG",
        "HK",
        "TW",
        "ZA"
      ]
    },
    "analyzeSentiment": {
      "description": "Classify sentiment toward highlightBrand in each answer. Requires highlightBrand. Spends one EXTRA AI-gateway operation on top of the base call — never charged unless both this and highlightBrand are set.",
      "type": "boolean"
    }
  },
  "required": [
    "projectId",
    "prompt",
    "models"
  ]
}

research_ai_prompts

Turns a seed topic into candidate prompts worth tracking (real Google/Bing autocomplete completions reframed as questions) plus observed mention-rate signals from this project's own already-tracked prompts. This is NOT prompt search volume — no honest corpus of 'how many people ask this' exists anywhere this codebase can reach, so no volume or difficulty number is invented. FREE: no AI-gateway budget, no paid-plan gate, no credits spent.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
seedTopic	string	required	Topic to derive trackable prompt candidates from.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "seedTopic": {
      "type": "string",
      "minLength": 1,
      "description": "Topic to derive trackable prompt candidates from."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "seedTopic"
  ]
}

compare_ai_competitor_positioning

Runs ONE prompt through the explore_ai_prompt pipeline and checks a brand plus its named competitors against the SAME real per-model answers for mentions and citations. Bounded scope, stated plainly: this is what one prompt's observed answers show for the named entities — never a comprehensive cross-prompt visibility score. `mentionedByCount` / `citedByCount` are raw counts out of `successfulModelCount`, never a percentage or ranking. `entities[0]` is always the target brand; the rest are the competitors in submitted order. A model that failed upstream reports `status: "error"` with `mentioned`/`cited: null` for every entity — null, not false, because that model was never checked. REQUIRES A PAID PLAN and CHARGES the same as explore_ai_prompt for the requested models; comparing more competitors against that one set of answers costs nothing extra.

Parameters7

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prompt	string	required	The one prompt every requested model answers.
brand	string	required	The target brand, domain or product checked in each answer.
competitors	array	required	1-5 competitor brands/domains checked against the same answers.
models	array	required	1-4 model personas, as for explore_ai_prompt (persona labels, not vendor-verified models).
webSearch	boolean	optional	Ground the answers in a real retrieval pass with cited sources. Defaults to true.
webSearchCountryCode	string	optional	Two-letter country the retrieval pass searches from.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The one prompt every requested model answers."
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "The target brand, domain or product checked in each answer."
    },
    "competitors": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 250
      },
      "description": "1-5 competitor brands/domains checked against the same answers."
    },
    "models": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "chat_gpt",
          "claude",
          "gemini",
          "perplexity"
        ]
      },
      "description": "1-4 model personas, as for explore_ai_prompt (persona labels, not vendor-verified models)."
    },
    "webSearch": {
      "type": "boolean",
      "description": "Ground the answers in a real retrieval pass with cited sources. Defaults to true."
    },
    "webSearchCountryCode": {
      "type": "string",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "IE",
        "DE",
        "FR",
        "ES",
        "IT",
        "NL",
        "PT",
        "PL",
        "SE",
        "NO",
        "DK",
        "BR",
        "MX",
        "IN",
        "JP",
        "KR",
        "SG",
        "HK",
        "TW",
        "ZA"
      ],
      "description": "Two-letter country the retrieval pass searches from."
    }
  },
  "required": [
    "projectId",
    "prompt",
    "brand",
    "competitors",
    "models"
  ]
}

get_direct_vendor_answers

Runs a prompt against up to 5 REAL, directly-verified vendor models — you_com (You.com Answer API), deepseek, grok (xAI), meta_ai (Meta's Model API) and minimax — each called through that vendor's own public API. Unlike explore_ai_prompt's persona labels, every result here reports the real vendor model id in `modelName`. A model whose API key is not configured on this deployment answers `status: "unavailable"` with no call made — a deployment fact, not an error; `status: "error"` means the vendor is configured but the call failed. `webSearch` is best-effort per vendor: You.com is always grounded, grok honours it, and deepseek, meta_ai and minimax always answer `webSearch: false`. meta_ai is a US-developers-only public preview, so an ineligible account reports an error naming that. Billed on the operator's own vendor keys: no plan gate and no MisarSEO credits are spent.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prompt	string	required	The prompt to send to each requested vendor model.
models	array	required	1-5 vendor models to ask.
highlightBrand	string	optional	A brand/entity name to highlight mentions of in each answer.
webSearch	boolean	optional	Ask for grounded answers where the vendor supports it (see the tool description). Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "description": "The prompt to send to each requested vendor model."
    },
    "models": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "enum": [
          "you_com",
          "deepseek",
          "grok",
          "meta_ai",
          "minimax"
        ]
      },
      "description": "1-5 vendor models to ask."
    },
    "highlightBrand": {
      "type": "string",
      "description": "A brand/entity name to highlight mentions of in each answer."
    },
    "webSearch": {
      "type": "boolean",
      "description": "Ask for grounded answers where the vendor supports it (see the tool description). Defaults to false."
    }
  },
  "required": [
    "projectId",
    "prompt",
    "models"
  ]
}

get_brand_scan_trend

The recorded AI-visibility history for one brand or domain: mentions, cited sources and competitors seen at each past Brand Radar scan, oldest first. Answers whether visibility in AI answers is moving, which a single run_brand_radar_scan cannot. Returns only scans that actually ran — empty for a target never scanned, filling in as scans run, with nothing interpolated or back-filled. FREE — reads recorded scans, charges no credits.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
target	string	required	Brand or domain, matched case-insensitively against past scans.
since	string	optional	Inclusive lower bound, YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "target": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Brand or domain, matched case-insensitively against past scans."
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  },
  "required": [
    "projectId",
    "target"
  ]
}

list_brand_monitors

Lists a project's brand monitors — targets re-scanned by Brand Radar on a schedule rather than only when run_brand_radar_scan is called. FREE: database only, no credits spent.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

upsert_brand_monitor

Creates or replaces a brand monitor — the whole schedule and competitor list, not single fields. Requires the admin role in the calling organization, because it starts UNATTENDED RECURRING spend from the SAME monthly Brand Radar scan quota that run_brand_radar_scan uses, which can leave less quota for ad hoc scans that month. Confirm the schedule with the user before calling.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
brandTarget	string	required	Brand, domain or product name to monitor.
scheduleInterval	string	required	How often the monitor re-scans.
competitors	array	required	Up to 5 competitor brands/domains to compare against. Send [] for none.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "brandTarget": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Brand, domain or product name to monitor."
    },
    "scheduleInterval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "description": "How often the monitor re-scans."
    },
    "competitors": {
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Up to 5 competitor brands/domains to compare against. Send [] for none."
    }
  },
  "required": [
    "projectId",
    "brandTarget",
    "scheduleInterval",
    "competitors"
  ]
}

delete_brand_monitor

Deletes a brand monitor, stopping its scheduled scans. Requires the admin role in the calling organization. Get the monitorId from list_brand_monitors.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
monitorId	string	required	Brand monitor ID, from list_brand_monitors.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "monitorId": {
      "type": "string",
      "minLength": 1,
      "description": "Brand monitor ID, from list_brand_monitors."
    }
  },
  "required": [
    "projectId",
    "monitorId"
  ]
}

list_tracked_prompts

Lists a project's tracked prompts — prompts re-run through explore_ai_prompt's real answer pipeline on a schedule and diffed against the previous check for mention/citation drops. FREE: database only, no credits spent.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

upsert_tracked_prompt

Creates or replaces a tracked prompt — the whole model list and schedule, not single fields. On every scheduled check the SAME prompt is re-run (grounded, for real citations) and diffed against the previous check. Requires the admin role in the calling organization, because it starts UNATTENDED RECURRING spend from the shared AI-gateway monthly budget. Confirm the schedule and models with the user before calling.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prompt	string	required	The prompt to re-run on every check.
brandTarget	string	required	The brand whose mentions and citations are tracked.
models	array	required	1-4 model personas, as for explore_ai_prompt.
scheduleInterval	string	required	How often the prompt is re-checked.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The prompt to re-run on every check."
    },
    "brandTarget": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "The brand whose mentions and citations are tracked."
    },
    "models": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "chat_gpt",
          "claude",
          "gemini",
          "perplexity"
        ]
      },
      "description": "1-4 model personas, as for explore_ai_prompt."
    },
    "scheduleInterval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "description": "How often the prompt is re-checked."
    }
  },
  "required": [
    "projectId",
    "prompt",
    "brandTarget",
    "models",
    "scheduleInterval"
  ]
}

delete_tracked_prompt

Deletes a tracked prompt, stopping its scheduled checks. Requires the admin role in the calling organization. Get the trackedPromptId from list_tracked_prompts.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
trackedPromptId	string	required	Tracked prompt ID, from list_tracked_prompts.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "trackedPromptId": {
      "type": "string",
      "minLength": 1,
      "description": "Tracked prompt ID, from list_tracked_prompts."
    }
  },
  "required": [
    "projectId",
    "trackedPromptId"
  ]
}

get_tracked_prompt_trend

Observed history for one tracked prompt — one point per real scheduled check (`mentionedByCount`/`citedByCount` out of `successfulModelCount`), oldest first. Empty until checks accumulate; never interpolated or back-filled. FREE — reads recorded checks.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
trackedPromptId	string	required	Tracked prompt ID, from list_tracked_prompts.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "trackedPromptId": {
      "type": "string",
      "minLength": 1,
      "description": "Tracked prompt ID, from list_tracked_prompts."
    }
  },
  "required": [
    "projectId",
    "trackedPromptId"
  ]
}

get_unlinked_mentions_report

Unlinked brand mentions: searches the free SERP backend for `brand` as a QUERY, then checks whether each result page already links to `trackedDomain`. Free: one SERP fetch plus up to 10 live third-party page fetches, no AI-gateway spend. ALWAYS narrow on `state` first: `serp_unavailable` means no free SERP provider could be reached — never treat it as "zero mentions found". `analysed` carries `candidates[]`, each `status: "linked" | "unlinked" | "unreachable"`. Bounded by SERP result count (the first page or two of free-SERP results), never an exhaustive web crawl or a full content index — the Common Crawl-based version of this gap is a decided wont-fix; `scopeNote` states this on every response. `candidates[].platform` reuses the AI-citation platform classification (YouTube/TikTok/Reddit/Wikipedia/LinkedIn/Quora, or null) at no extra cost.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
brand	string	required	Brand name or bare domain to search for as a SERP QUERY (not a URL to fetch).
trackedDomain	string	required	Bare domain each result page is checked for a link to, e.g. 'acme.com'.
locationCode	integer	optional	Numeric location code. Defaults to the project's stored market, else 2840 (United States).
languageCode	string	optional	Language code. Defaults to the project's stored market, else 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "description": "Brand name or bare domain to search for as a SERP QUERY (not a URL to fetch)."
    },
    "trackedDomain": {
      "type": "string",
      "minLength": 1,
      "description": "Bare domain each result page is checked for a link to, e.g. 'acme.com'."
    },
    "locationCode": {
      "description": "Numeric location code. Defaults to the project's stored market, else 2840 (United States).",
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "languageCode": {
      "description": "Language code. Defaults to the project's stored market, else 'en'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 8
    }
  },
  "required": [
    "projectId",
    "brand",
    "trackedDomain"
  ]
}

get_media_monitoring_report

Media Monitoring: get_unlinked_mentions_report's candidates filtered to known social/forum/news platform domains, optionally merged with the citation-platform breakdown from a Prompt Explorer scan you already ran for the same brand. Same cost profile as `get_unlinked_mentions_report`, which this calls internally — no AI-gateway spend, even when `citations` is supplied (that data is only classified here, never fetched). NOT a real-time media-monitoring product: no social-platform API polling, no forum-API crawling, no news-aggregator feed — `scopeNote` states this on every `analysed` response. ALWAYS narrow on `state` first, same as `get_unlinked_mentions_report`. `aiCitationPlatforms: null` means no `citations` were supplied — distinct from an empty array, which would mean a scan cited nothing on a known platform.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
brand	string	required	Brand name or bare domain to search for as a SERP QUERY (not a URL to fetch).
trackedDomain	string	required	Bare domain each result page is checked for a link to, e.g. 'acme.com'.
locationCode	integer	optional	Numeric location code. Defaults to the project's stored market, else 2840 (United States).
languageCode	string	optional	Language code. Defaults to the project's stored market, else 'en'.
citations	array	optional	Citations from an ALREADY-RUN Prompt Explorer scan for this brand (map its `citations` to {url, domain}). Never fetched here — omitting it leaves `aiCitationPlatforms: null`.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "description": "Brand name or bare domain to search for as a SERP QUERY (not a URL to fetch)."
    },
    "trackedDomain": {
      "type": "string",
      "minLength": 1,
      "description": "Bare domain each result page is checked for a link to, e.g. 'acme.com'."
    },
    "locationCode": {
      "description": "Numeric location code. Defaults to the project's stored market, else 2840 (United States).",
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "languageCode": {
      "description": "Language code. Defaults to the project's stored market, else 'en'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 8
    },
    "citations": {
      "description": "Citations from an ALREADY-RUN Prompt Explorer scan for this brand (map its `citations` to {url, domain}). Never fetched here — omitting it leaves `aiCitationPlatforms: null`.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "url",
          "domain"
        ]
      }
    }
  },
  "required": [
    "projectId",
    "brand",
    "trackedDomain"
  ]
}

search_local_businesses

Searches local business listings near a coordinate. Use this to find local business candidates or nearby competitors; it does not run Maps rank checks or Q&A. CHARGES CREDITS ONLY WHEN APIFY IS CONFIGURED AND ITS SHARED MONTHLY BUDGET HAS ROOM: results then come from a real, independently-run scrape of Google Places (`dataSource: "apify_google_places"`) — real ratings, since OpenStreetMap never has one. Otherwise (Apify unconfigured, over budget, or the actor call failed) NOTHING IS CHARGED and this falls back automatically to OpenStreetMap (Overpass, then Nominatim) — real point-of-interest data, no key (`dataSource: "openstreetmap"`) — whose coverage is uneven and carries none of a commercial directory's ranking, review or category metadata. Do not present an OpenStreetMap result set as the complete set of businesses in the area; the response's own `dataSource` field on each row says which source actually answered it, never assume. `categories` values are common category names (e.g. 'restaurant', 'dentist'); OpenStreetMap matches them on a best-effort basis, so a category that returns nothing on that path may simply be unmapped there rather than absent from the area — an empty result is not measured coverage of the area, and a listing's missing rating or review count is likewise not measured, never zero.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
query	string	optional	Business name or title text to match.
near	object	required	Coordinate and radius to search around.
categories	array	optional	Business categories to filter by (e.g. 'pizza_restaurant').
limit	integer	optional	Maximum businesses to return (1-50). Defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "query": {
      "description": "Business name or title text to match.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "near": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Latitude of the search center."
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Longitude of the search center."
        },
        "radiusKm": {
          "type": "number",
          "minimum": 1,
          "maximum": 100000,
          "description": "Search radius around the center, in kilometers. get_google_business_questions clamps it to roughly 0.2-200 km and ignores it entirely on the free provider — see that tool's description before reporting a radius as applied."
        }
      },
      "required": [
        "latitude",
        "longitude",
        "radiusKm"
      ],
      "description": "Coordinate and radius to search around."
    },
    "categories": {
      "description": "Business categories to filter by (e.g. 'pizza_restaurant').",
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "limit": {
      "description": "Maximum businesses to return (1-50). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "projectId",
    "near"
  ]
}

get_google_business_questions

Fetches question-and-answer rows for one business keyword. Run this only when Q&A evidence is needed. THE TWO PROVIDERS RETURN DIFFERENT THINGS AND YOU MUST SAY WHICH YOU HAVE. On the paid data provider these are real Google Business Profile questions and answers for a profile near `near`, and it CHARGES CREDITS. On the default free provider they are Google/Bing autocomplete completions reframed as questions — real search phrasings, but NOT anybody's Business Profile Q&A, with no answers and no asker — and NOTHING IS CHARGED. Never attribute a free-provider row to a business or quote it as a customer's question. `near` IS IGNORED ON THE FREE PROVIDER: the suggest APIs take no geography, so the same keyword returns the same rows from any coordinate. It is required because the paid provider needs it, not because the result is always localised. On the paid provider `radiusKm` is converted to metres and clamped into 200 m - 199,999 m, so a radius above about 200 km is silently reduced to that ceiling. An empty result means no Q&A was found for this phrasing; whether the business has questions elsewhere was not measured.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
keyword	string	required	Business name or search phrase identifying the Google Business Profile.
near	object	required	Coordinate and radius to search around.
depth	integer	optional	Maximum Q&A rows to fetch (1-100). Defaults to 20.
languageCode	string	optional	Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Business name or search phrase identifying the Google Business Profile."
    },
    "near": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Latitude of the search center."
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Longitude of the search center."
        },
        "radiusKm": {
          "type": "number",
          "minimum": 1,
          "maximum": 100000,
          "description": "Search radius around the center, in kilometers. get_google_business_questions clamps it to roughly 0.2-200 km and ignores it entirely on the free provider — see that tool's description before reporting a radius as applied."
        }
      },
      "required": [
        "latitude",
        "longitude",
        "radiusKm"
      ],
      "description": "Coordinate and radius to search around."
    },
    "depth": {
      "description": "Maximum Q&A rows to fetch (1-100). Defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "description": "Language code (e.g. 'en', 'es', 'fr'). Omit it to use the project's default market language, which falls back to 'en'."
    }
  },
  "required": [
    "projectId",
    "keyword",
    "near"
  ]
}

run_local_nap_audit

Compare a claimed business Name/Address/Phone against listings the free OpenStreetMap business search finds near the claimed location. PARTIAL scope: checks ONE open source, not a multi-directory citation crawl (a multi-directory crawl needs licensed directory-API access this deployment does not have). A found field with no value is reported notComparable, never scored as a mismatch. `overallScore` on each match is a mean of comparable-field similarities (0-1), null when nothing was comparable.

Parameters7

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
name	string	required	Claimed business name.
address	string	required	Claimed address, any format.
phone	string	required	Claimed phone number, any format.
latitude	number	required
longitude	number	required
radiusKm	number	required	Search radius around the claimed location, in km.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Claimed business name."
    },
    "address": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Claimed address, any format."
    },
    "phone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50,
      "description": "Claimed phone number, any format."
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radiusKm": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000,
      "description": "Search radius around the claimed location, in km."
    }
  },
  "required": [
    "projectId",
    "name",
    "address",
    "phone",
    "latitude",
    "longitude",
    "radiusKm"
  ]
}

get_local_pack_rank

Read-only access to local pack rank check configs and their latest check. With `configId`, returns that config's latest check: `status` is "found" (a real 1-based `position` within Google's local pack), "not_found" (the page parsed cleanly but the business was not among the entries seen), or "unavailable" (the scraper is disabled, blocked, or nothing could be parsed) — never a fabricated position or confidence score. Without `configId`, lists all local pack rank configs in the project. This checks Google's LOCAL PACK for a named BUSINESS, distinct from get_local_rank_grid, which checks ORGANIC rank for a DOMAIN across a geo-grid. Create a config with create_local_pack_rank_config and run a new check with run_local_pack_rank_check.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	optional	Local pack rank config ID. If omitted, lists all configs in the project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "description": "Local pack rank config ID. If omitted, lists all configs in the project.",
      "type": "string"
    }
  },
  "required": [
    "projectId"
  ]
}

get_local_rank_grid

Read-only access to geo-grid rank-tracking configs and their latest run. With `configId`, returns that config's latest run plus per-point results (position, url, and the place name each point was reverse-geocoded to for its location override — null means no override was applied). Without it, lists all grid configs in the project. Reports ORGANIC rank at each point, NEVER local-pack position — the free SERP backend does not parse a local pack. Create a config with create_local_rank_grid_config and trigger a run with run_local_rank_grid.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	optional	Grid config ID. If omitted, lists all grid configs in the project.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "description": "Grid config ID. If omitted, lists all grid configs in the project.",
      "type": "string"
    }
  },
  "required": [
    "projectId"
  ]
}

get_gbp_profile

Read-only Google Business Profile listing profile for the project's linked location: title, categories, phone, website, description, hours-period count, and which of Google's attribute taxonomy entries are set. Fetched LIVE from Google on every call. Returns NOT_FOUND if no location is linked yet — link one with set_gbp_connection (list_gbp_locations has the ids).

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_gbp_performance

Read-only Business Profile Performance API metrics for the project's linked location over an inclusive date range. `metrics` must be real DailyMetric values: BUSINESS_IMPRESSIONS_DESKTOP_MAPS, BUSINESS_IMPRESSIONS_DESKTOP_SEARCH, BUSINESS_IMPRESSIONS_MOBILE_MAPS, BUSINESS_IMPRESSIONS_MOBILE_SEARCH, BUSINESS_CONVERSATIONS, BUSINESS_DIRECTION_REQUESTS, CALL_CLICKS, WEBSITE_CLICKS, BUSINESS_BOOKINGS, BUSINESS_FOOD_ORDERS, BUSINESS_FOOD_MENU_CLICKS.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
metrics	array	required	Which daily metrics to fetch.
startDate	string	required	Inclusive start date, YYYY-MM-DD.
endDate	string	required	Inclusive end date, YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "metrics": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "BUSINESS_IMPRESSIONS_DESKTOP_MAPS",
          "BUSINESS_IMPRESSIONS_DESKTOP_SEARCH",
          "BUSINESS_IMPRESSIONS_MOBILE_MAPS",
          "BUSINESS_IMPRESSIONS_MOBILE_SEARCH",
          "BUSINESS_CONVERSATIONS",
          "BUSINESS_DIRECTION_REQUESTS",
          "CALL_CLICKS",
          "WEBSITE_CLICKS",
          "BUSINESS_BOOKINGS",
          "BUSINESS_FOOD_ORDERS",
          "BUSINESS_FOOD_MENU_CLICKS"
        ]
      },
      "description": "Which daily metrics to fetch."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start date, YYYY-MM-DD."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end date, YYYY-MM-DD."
    }
  },
  "required": [
    "projectId",
    "metrics",
    "startDate",
    "endDate"
  ]
}

get_gbp_reviews

Read-only reviews for the project's linked Google Business Profile location, one Google-paginated page at a time.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
pageToken	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "pageToken": {
      "type": "string"
    }
  },
  "required": [
    "projectId"
  ]
}

reply_to_gbp_review

Reply to (or overwrite the reply on) one review, by reviewId from get_gbp_reviews. Google's endpoint has no separate create/update — this always overwrites. Publishes immediately; there is no draft/preview step.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reviewId	string	required
comment	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reviewId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "comment": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    }
  },
  "required": [
    "projectId",
    "reviewId",
    "comment"
  ]
}

get_gbp_optimization

Completeness/quality score and AI-grounded optimization recommendations for the project's linked Google Business Profile location. The `score` (0-100) is a DETERMINISTIC heuristic checklist over real measured facts — not AI-generated. Only `recommendations` comes from the model. CHARGES ONE AI-GATEWAY OPERATION against the organization's shared monthly ceiling.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

list_gbp_locations

Every Google Business Profile account and location this deployment's operator credential can manage — the picker data for set_gbp_connection. Not project-scoped data (the answer does not depend on the project passed; projectId only satisfies the ownership check). Returns `{ accounts: [{ name, accountName, locations: [...] }] }`. Live Google API calls.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_gbp_connection

The project's currently linked Google Business Profile location, or `{ connection: null }` when none is linked yet. FREE: database only.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_gbp_connection

Links (or repoints) a project to a Google Business Profile location. Take googleAccountId and googleLocationId verbatim from list_gbp_locations — both are Google's own resource names (e.g. "accounts/123", "locations/456"), not free text. Repointing replaces the existing link.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
googleAccountId	string	required	Google account resource name, e.g. accounts/123.
googleLocationId	string	required	Google location resource name, e.g. locations/456.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "googleAccountId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Google account resource name, e.g. accounts/123."
    },
    "googleLocationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Google location resource name, e.g. locations/456."
    }
  },
  "required": [
    "projectId",
    "googleAccountId",
    "googleLocationId"
  ]
}

disconnect_gbp

Removes the project's link to its Google Business Profile location. Only MisarSEO's own record of the link is removed — the location on Google is untouched — but every GBP tool stops working for the project until it is linked again.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

list_gbp_posts

Posts published on the project's linked Google Business Profile location. A 404 means no location is linked — use set_gbp_connection first.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

create_gbp_post

Publishes a new "What's New" post on the linked Google Business Profile location. It goes LIVE and PUBLIC immediately — there is no draft state and no undo here. Show the user the exact text and get their explicit approval before calling. Only standard posts are supported (no event, offer or alert fields).

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
summary	string	required	The post text.
languageCode	string	optional	Language of the post. Defaults to en.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1500,
      "description": "The post text."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "maxLength": 10,
      "description": "Language of the post. Defaults to en."
    }
  },
  "required": [
    "projectId",
    "summary"
  ]
}

delete_gbp_review_reply

Removes the owner's published reply from one Google review (reviewId from get_gbp_reviews). The removal is public and immediate. Confirm with the user before calling.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reviewId	string	required	Review ID, from get_gbp_reviews.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reviewId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Review ID, from get_gbp_reviews."
    }
  },
  "required": [
    "projectId",
    "reviewId"
  ]
}

create_local_pack_rank_config

Creates a local pack rank check config: where businessName sits in Google's local pack for one keyword at one location. The location is composed into the query as "<keyword> in <locationLabel>" — not geocoded. Run checks with run_local_pack_rank_check and read them with get_local_pack_rank. FREE: database only.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
businessName	string	required	The business name as it appears on Google.
keyword	string	required	The search keyword, e.g. 'coffee shop'.
locationLabel	string	required	Place appended to the query, e.g. 'Shoreditch, London'.
languageCode	string	optional	Search language code.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "businessName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The business name as it appears on Google."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The search keyword, e.g. 'coffee shop'."
    },
    "locationLabel": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Place appended to the query, e.g. 'Shoreditch, London'."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "maxLength": 10,
      "description": "Search language code."
    }
  },
  "required": [
    "projectId",
    "businessName",
    "keyword",
    "locationLabel"
  ]
}

delete_local_pack_rank_config

Deletes a local pack rank check config, INCLUDING its whole check history. Confirm with the user before calling.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Config ID, from the matching get_* tool called without configId.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Config ID, from the matching get_* tool called without configId."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

run_local_pack_rank_check

Runs a local pack rank check now — one live scrape of Google's public local search results (not the paid Places API). Returns "found" with a real 1-based position, "not_found" (parsed cleanly, business absent), or "unavailable" (scraper disabled, blocked, or unparsable) — never a fabricated position. Fails with SEO_DATA_UNAVAILABLE where the deployment has not enabled the scraper. Tightly rate limited, so do not loop it.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Config ID, from the matching get_* tool called without configId.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Config ID, from the matching get_* tool called without configId."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

create_local_rank_grid_config

Creates a geo-grid rank-tracking config: a 3x3 grid of points around a centre coordinate, checking ORGANIC rank for one keyword and domain from each point. centerLabel must name the place the grid is centred on — a heatmap with no stated centre is a claim about nowhere. Run it with run_local_rank_grid and read it with get_local_rank_grid. FREE: database only.

Parameters8

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Domain whose organic rank is checked.
keyword	string	required	The search keyword.
centerLat	number	required	Latitude of the grid centre.
centerLng	number	required	Longitude of the grid centre.
centerLabel	string	required	What the centre point is called, e.g. 'Manchester city centre'.
spacingKm	number	required	Distance between grid points, 0.5-25 km.
languageCode	string	optional	Search language code.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253,
      "description": "Domain whose organic rank is checked."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The search keyword."
    },
    "centerLat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude of the grid centre."
    },
    "centerLng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude of the grid centre."
    },
    "centerLabel": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "What the centre point is called, e.g. 'Manchester city centre'."
    },
    "spacingKm": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 25,
      "description": "Distance between grid points, 0.5-25 km."
    },
    "languageCode": {
      "type": "string",
      "minLength": 2,
      "maxLength": 10,
      "description": "Search language code."
    }
  },
  "required": [
    "projectId",
    "domain",
    "keyword",
    "centerLat",
    "centerLng",
    "centerLabel",
    "spacingKm"
  ]
}

delete_local_rank_grid_config

Deletes a geo-grid rank-tracking config, INCLUDING its whole run and point history. Confirm with the user before calling.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Config ID, from the matching get_* tool called without configId.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Config ID, from the matching get_* tool called without configId."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

run_local_rank_grid

Runs a geo-grid rank check now — up to 9 live SERP calls plus up to 9 reverse-geocode calls. Reports ORGANIC rank at each grid point, never local-pack position. Fails with SEO_DATA_UNAVAILABLE where the SERP provider cannot override location per point. Tightly rate limited, so do not loop it.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
configId	string	required	Config ID, from the matching get_* tool called without configId.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "configId": {
      "type": "string",
      "minLength": 1,
      "description": "Config ID, from the matching get_* tool called without configId."
    }
  },
  "required": [
    "projectId",
    "configId"
  ]
}

get_web_analytics_summary

Sessions/pageviews/bounce-rate time series for a project's own tracking snippet. FREE — first-party data collected by MisarSEO's own snippet (/api/analytics/snippet.js), never a paid or rate-limited third-party call. `totals.bounceRate` is null (not 0) when there were no sessions in the range.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_web_analytics_top_pages

Top pages by view count, plus separate entry-page and exit-page breakdowns, for a project's own tracking snippet. FREE, first-party.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.
limit	integer	optional	Rows per list (topPages/entryPages/exitPages), 1-200, default 50.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    },
    "limit": {
      "description": "Rows per list (topPages/entryPages/exitPages), 1-200, default 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_web_analytics_sources

Referrer/channel/UTM breakdown for a project's own tracking snippet, including AI referral attribution: aiReferral.bySource breaks the ai-referral channel out by assistant (chatgpt/claude/perplexity/gemini/copilot/you/poe). aiReferral.undercountNote is not decoration — industry measurement puts a large share of real AI-assistant referrals arriving with no referrer header at all, landing in the direct channel instead. This number is a measurable floor, never a complete count. FREE, first-party.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.
referrerLimit	integer	optional	Rows in topReferrers, 1-200, default 50.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    },
    "referrerLimit": {
      "description": "Rows in topReferrers, 1-200, default 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_web_analytics_devices

Device/browser/OS breakdown for a project's own tracking snippet. Every field is derived server-side from the visitor's User-Agent header at collection time. FREE, first-party.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

list_ga4_properties

Every GA4 property the caller's connected Google Analytics grant can access — the data source for picking which property to bind to a project (see set_ga4_property). Live call to the Analytics Admin API (accountSummaries.list), not an archive read. Read-only and FREE (no credits). Check `requiresReconnect` before treating an empty `properties` list as 'no properties': true means the stored grant can no longer reach Google Analytics.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_ga4_property

Link (or repoint) a project's Google Analytics property. `propertyId` is re-validated against the caller's LIVE property list on every call — fails if the property fell out of the connected account's access since it was last listed via list_ga4_properties.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
propertyId	string	required	Bare numeric GA4 property id (no 'properties/' prefix), taken verbatim from list_ga4_properties.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "propertyId": {
      "type": "string",
      "minLength": 1,
      "description": "Bare numeric GA4 property id (no 'properties/' prefix), taken verbatim from list_ga4_properties."
    }
  },
  "required": [
    "projectId",
    "propertyId"
  ]
}

disconnect_ga4

Unlink a project's Google Analytics property. Breaks Analytics data for every member of the organization, not just the caller — requires at least the admin role.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_ga4_performance_summary

MisarSEO's own retained daily Google Analytics totals for the connected property: sessions, activeUsers, newUsers, engagementRate, bounceRate, conversions, screenPageViews. Read-only and FREE (no credits) — makes NO call to Google, reads only what the nightly sync (04:25 UTC) has archived. A property with no completed sync yet simply has no rows, not stale data.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_ga4_channel_breakdown

MisarSEO's own retained daily GA4 channel breakdown (sessionDefaultChannelGroup) for the connected property — isolating Organic Search from every other acquisition channel, the SEO-relevant signal GA4 adds beyond Search Console's own click/impression data. Read-only and FREE (no credits), archive-only — same sync/quota story as get_ga4_performance_summary.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

get_ga4_landing_pages

MisarSEO's own retained daily GA4 landing-page breakdown for the connected property: sessions/engagement/conversions per landing page, ordered by sessions descending within each day. Read-only and FREE (no credits), archive-only — same sync/quota story as get_ga4_performance_summary.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
startDate	string	required	YYYY-MM-DD, required.
endDate	string	required	YYYY-MM-DD, required, not before startDate.
limit	integer	optional	Rows to return, 1-1000 (default 1000). Landing-page cardinality is unbounded for a large site.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD, required, not before startDate."
    },
    "limit": {
      "description": "Rows to return, 1-1000 (default 1000). Landing-page cardinality is unbounded for a large site.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "projectId",
    "startDate",
    "endDate"
  ]
}

log_analyzer_list_uploads

A project's server-log uploads and their parse status — the Log File Analyzer / Bot Analytics feature. Each row is `{ id, fileName, sizeBytes, status, lineCount, parsedLineCount, skippedLineCount, errorMessage, createdAt, completedAt }`. `status` is one of queued/parsing/completed/failed. lineCount/parsedLineCount/skippedLineCount are null until parsing completes — an absent count is not zero. FREE (no credits). Pair with log_analyzer_upload to add a log, log_analyzer_daily_summary / log_analyzer_top_paths for the report.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

log_analyzer_upload

Upload a server access log for background parsing (Log File Analyzer / Bot Analytics). Only Apache/Nginx Combined Log Format text is supported. Pass the raw log text in `content`; parsing runs in the background, so this returns once the upload is stored, before it is fully processed — poll log_analyzer_list_uploads for status. Requires the `admin` role. Plan-tier gated: the deployment's tier caps lines processed per upload and uploads per month. Practical limit: tool calls carrying megabytes of text are impractical — prefer the web UI for large logs. FREE (no credits).

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
fileName	string	required	The log file's name, e.g. 'access.log'.
content	string	required	Raw Combined Log Format text, one line per request.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "fileName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The log file's name, e.g. 'access.log'."
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "description": "Raw Combined Log Format text, one line per request."
    }
  },
  "required": [
    "projectId",
    "fileName",
    "content"
  ]
}

log_analyzer_daily_summary

Bot hit counts per (day, bot category, bot label, status code, content-type bucket) across every log upload in the date range — powers a time-series, status-code, or content-type view of bot traffic. Rows are `{ day, botCategory, botLabel, statusCode, contentType, hitCount }`; botCategory is ai_crawler/search_engine/other_bot. Dates are ISO (YYYY-MM-DD), UTC. An empty result means nothing was measured in the range — no bot hits were recorded from the logs uploaded for those days, which is not the same as no bots visiting. FREE (no credits).

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
sinceDay	string	required	Inclusive start day, ISO date, UTC.
untilDay	string	required	Inclusive end day, ISO date, UTC.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "sinceDay": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start day, ISO date, UTC."
    },
    "untilDay": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end day, ISO date, UTC."
    }
  },
  "required": [
    "projectId",
    "sinceDay",
    "untilDay"
  ]
}

log_analyzer_top_paths

The paths bots hit most, per (bot category, bot label, path, status code) — the busiest-paths table of Bot Analytics. Rows are `{ botCategory, botLabel, path, statusCode, hitCount, lastSeenAt }`, ordered by hitCount descending, capped at 200. Optionally filter to one bot category (ai_crawler/search_engine/other_bot). An empty result means nothing was measured — no bot path hits were recorded from uploaded logs. FREE (no credits).

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
botCategory	string	optional	Filter to one bot category; omit for all.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "botCategory": {
      "description": "Filter to one bot category; omit for all.",
      "type": "string",
      "enum": [
        "ai_crawler",
        "search_engine",
        "other_bot"
      ]
    }
  },
  "required": [
    "projectId"
  ]
}

list_link_prospects

Link Building Tool: every prospect for a project, newest first, each enriched with a LIVE domain-authority read (never cached, never an invented score). FREE (no credits). White-hat scope: research + outreach assistance only.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

add_link_prospect

Link Building Tool: add one prospect domain/page to a project's list. FREE (no credits), but this is a MUTATION. White-hat scope: contact fields are plain manually-typed free text — NEVER auto-scraped or guessed. New prospects start at status 'prospected'; use update_link_prospect_status to move them through the pipeline.

Parameters9

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
domain	string	required	Bare domain, e.g. example.com.
url	string	optional	Optional specific page on domain, a full absolute URL.
label	string	optional
targetUrl	string	optional	The project's OWN page this outreach is trying to get linked.
contactName	string	optional
contactEmail	string	optional
contactNotes	string	optional
note	string	optional	Optional first activity-log entry, e.g. 'Found via competitor backlink profile.'

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "description": "Bare domain, e.g. example.com."
    },
    "url": {
      "description": "Optional specific page on domain, a full absolute URL.",
      "type": "string",
      "format": "uri"
    },
    "label": {
      "type": "string",
      "maxLength": 200
    },
    "targetUrl": {
      "description": "The project's OWN page this outreach is trying to get linked.",
      "type": "string",
      "format": "uri"
    },
    "contactName": {
      "type": "string",
      "maxLength": 300
    },
    "contactEmail": {
      "type": "string",
      "maxLength": 300
    },
    "contactNotes": {
      "type": "string",
      "maxLength": 1000
    },
    "note": {
      "description": "Optional first activity-log entry, e.g. 'Found via competitor backlink profile.'",
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "projectId",
    "domain"
  ]
}

update_link_prospect

Link Building Tool: edit a prospect's editable fields (url/label/targetUrl/contact fields) — only fields given here are changed. FREE (no credits), but this is a MUTATION. `domain` and `status` are not editable here — use update_link_prospect_status for the pipeline stage.

Parameters8

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prospectId	string	required	Prospect id, from list_link_prospects.
url	string	optional
label	string	optional
targetUrl	string	optional
contactName	string	optional
contactEmail	string	optional
contactNotes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prospectId": {
      "type": "string",
      "minLength": 1,
      "description": "Prospect id, from list_link_prospects."
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "label": {
      "type": "string",
      "maxLength": 200
    },
    "targetUrl": {
      "type": "string",
      "format": "uri"
    },
    "contactName": {
      "type": "string",
      "maxLength": 300
    },
    "contactEmail": {
      "type": "string",
      "maxLength": 300
    },
    "contactNotes": {
      "type": "string",
      "maxLength": 1000
    }
  },
  "required": [
    "projectId",
    "prospectId"
  ]
}

update_link_prospect_status

Link Building Tool: move a prospect through the outreach-status pipeline — prospected -> contacted -> replied -> link_placed/declined/no_response ('declined'/'no_response' can loop back to 'contacted' for a re-approach). FREE (no credits), but this is a MUTATION. Throws on an illegal jump (e.g. prospected straight to link_placed) — the error names the allowed next stage(s). Always appends an activity-log entry describing the change.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prospectId	string	required	Prospect id, from list_link_prospects.
status	string	required
note	string	optional	Optional extra context appended to the auto-generated activity-log entry, e.g. 'sent follow-up #2'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prospectId": {
      "type": "string",
      "minLength": 1,
      "description": "Prospect id, from list_link_prospects."
    },
    "status": {
      "type": "string",
      "enum": [
        "prospected",
        "contacted",
        "replied",
        "link_placed",
        "declined",
        "no_response"
      ]
    },
    "note": {
      "description": "Optional extra context appended to the auto-generated activity-log entry, e.g. 'sent follow-up #2'.",
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "projectId",
    "prospectId",
    "status"
  ]
}

remove_link_prospect

Link Building Tool: remove one prospect by id (from list_link_prospects), along with its activity log. FREE (no credits), but this is a MUTATION. Succeeds whether or not prospectId existed.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prospectId	string	required	Prospect id, from list_link_prospects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prospectId": {
      "type": "string",
      "minLength": 1,
      "description": "Prospect id, from list_link_prospects."
    }
  },
  "required": [
    "projectId",
    "prospectId"
  ]
}

list_link_prospect_activity

Link Building Tool: a prospect's activity log — every manually-typed note plus every auto-recorded status change, newest first. FREE (no credits).

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prospectId	string	required	Prospect id, from list_link_prospects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prospectId": {
      "type": "string",
      "minLength": 1,
      "description": "Prospect id, from list_link_prospects."
    }
  },
  "required": [
    "projectId",
    "prospectId"
  ]
}

add_link_prospect_note

Link Building Tool: add one manual activity-log entry to a prospect, e.g. "emailed on 9/5" or "follow-up sent". FREE (no credits), but this is a MUTATION.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
prospectId	string	required	Prospect id, from list_link_prospects.
note	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "prospectId": {
      "type": "string",
      "minLength": 1,
      "description": "Prospect id, from list_link_prospects."
    },
    "note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "projectId",
    "prospectId",
    "note"
  ]
}

import_link_prospects_csv

Link Building Tool: bulk-add up to 500 prospects at once from already-parsed rows (each with at least a domain). FREE (no credits), but this is a MUTATION. One bad or duplicate row never aborts the rest — the response reports added/duplicates/errors per row.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
rows	array	required	Rows to import, each with at least a domain.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "rows": {
      "minItems": 1,
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "minLength": 1,
            "maxLength": 253
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "targetUrl": {
            "type": "string",
            "format": "uri"
          },
          "contactName": {
            "type": "string",
            "maxLength": 300
          },
          "contactEmail": {
            "type": "string",
            "maxLength": 300
          },
          "contactNotes": {
            "type": "string",
            "maxLength": 1000
          }
        },
        "required": [
          "domain"
        ]
      },
      "description": "Rows to import, each with at least a domain."
    }
  },
  "required": [
    "projectId",
    "rows"
  ]
}

export_link_prospects_csv

Link Building Tool: export a project's prospect list as CSV text. FREE (no credits). Save `csvContent` to a .csv file as-is (UTF-8).

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_bing_site_overview

Bing's own view of a project's domain: daily search performance (clicks/impressions), per-query stats, own-site inbound links, remaining URL Submission quota, crawl diagnostics (crawl stats, crawl issues, crawl settings), submitted feeds and query-parameter settings — read straight from the Bing Webmaster API. FREE (no credits). Bring-your-own-key: requires the deployment operator to set BING_WEBMASTER_API_KEY (one key covers every site verified on that Bing account — no per-project connect step). Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account. Backlinks here are OWN-SITE ONLY — Bing exposes no competitor/any-domain backlink lookup, so this does not substitute for general backlink research. Per-URL lookups and keyword research have their own tools: get_bing_url_links, get_bing_url_info, get_bing_keyword_research.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_bing_backlinks

GetLinkCounts: own-site inbound-link page list for a project's matched Bing site — the focused, single-call form of the backlinks field already embedded in get_bing_site_overview. FREE (no credits). OWN-SITE ONLY: Bing exposes no competitor/any-domain backlink lookup, and some verified sites are known to return an empty result here even when populated. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
page	integer	optional	0-based page of Bing's own pagination (default 0).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "page": {
      "description": "0-based page of Bing's own pagination (default 0).",
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "projectId"
  ]
}

get_bing_url_links

GetUrlLinks: the inbound links (anchor text + source URL) pointing at one specific page on a project's matched Bing site, read straight from the Bing Webmaster API. FREE (no credits). Own-site only — Bing exposes no competitor/any-domain backlink lookup, and some verified sites are known to return an empty result here even when populated. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	The specific page to find inbound links for.
page	integer	optional	0-based page of Bing's own pagination (default 0).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The specific page to find inbound links for."
    },
    "page": {
      "description": "0-based page of Bing's own pagination (default 0).",
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "projectId",
    "url"
  ]
}

get_bing_url_info

GetUrlInfo + optionally GetChildrenUrlInfo: index/crawl metadata (anchor count, discovery/last-crawled dates, HTTP status, whether Bing considers it a page) for one URL on a project's matched Bing site, and, when includeChildren is set, the same metadata for every URL Bing discovered under it. FREE (no credits). Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	The URL to look up.
includeChildren	boolean	optional	Also fetch the index/crawl metadata for URLs discovered under this one (one page of Bing's own pagination). Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL to look up."
    },
    "includeChildren": {
      "description": "Also fetch the index/crawl metadata for URLs discovered under this one (one page of Bing's own pagination). Default false.",
      "type": "boolean"
    }
  },
  "required": [
    "projectId",
    "url"
  ]
}

get_bing_keyword_research

GetKeyword + GetKeywordStats + GetRelatedKeywords: real Bing impression data for a query, its recent weekly history, and related queries — read straight from the Bing Webmaster API. FREE (no credits). Unlike derived/estimated keyword metrics, these numbers come from Bing's own search-impression logs. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
query	string	required	The search query to research.
country	string	optional	Two-letter country code, e.g. 'us'.
language	string	optional	Language-region code, e.g. 'en-US'.
startDate	string	optional	YYYY-MM-DD. Applies to keyword/relatedKeywords only.
endDate	string	optional	YYYY-MM-DD. Applies to keyword/relatedKeywords only.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The search query to research."
    },
    "country": {
      "description": "Two-letter country code, e.g. 'us'.",
      "type": "string"
    },
    "language": {
      "description": "Language-region code, e.g. 'en-US'.",
      "type": "string"
    },
    "startDate": {
      "description": "YYYY-MM-DD. Applies to keyword/relatedKeywords only.",
      "type": "string"
    },
    "endDate": {
      "description": "YYYY-MM-DD. Applies to keyword/relatedKeywords only.",
      "type": "string"
    }
  },
  "required": [
    "projectId",
    "query"
  ]
}

get_bing_detail_stats

GetQueryTrafficStats + GetPageStats + GetPageQueryStats + GetQueryPageStats + GetQueryPageDetailStats: per-query and per-page search-performance detail for a project's matched Bing site. FREE (no credits). pageStats (site-wide, weekly) is always attempted. queryTrafficStats/queryPageStats are null unless `query` is given; pageQueryStats is null unless `pageUrl` is given; queryPageDetailStats is null unless both are given — a null section absent from `errors` was not requested, not a failure. pageStats carries one unresolved caveat: Microsoft's own doc page is internally inconsistent about whether that method's `query` field on each row holds a query string or a page URL — surfaced as-is. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
query	string	optional	The search query to fetch traffic/page stats for. Required for queryTrafficStats/queryPageStats (and, with pageUrl, queryPageDetailStats).
pageUrl	string	optional	The page to fetch query stats for. Required for pageQueryStats (and, with query, queryPageDetailStats).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "query": {
      "description": "The search query to fetch traffic/page stats for. Required for queryTrafficStats/queryPageStats (and, with pageUrl, queryPageDetailStats).",
      "type": "string",
      "minLength": 1
    },
    "pageUrl": {
      "description": "The page to fetch query stats for. Required for pageQueryStats (and, with query, queryPageDetailStats).",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "projectId"
  ]
}

get_bing_feed_details

GetFeedDetails: the same Feed shape as one entry from Bing's GetFeeds list, for one specific feed URL on a project's matched site. FREE (no credits), read-only. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
feedUrl	string	required	Absolute URL of the previously-submitted sitemap/feed.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "feedUrl": {
      "type": "string",
      "format": "uri",
      "description": "Absolute URL of the previously-submitted sitemap/feed."
    }
  },
  "required": [
    "projectId",
    "feedUrl"
  ]
}

submit_bing_content

SubmitContent: pushes a page's full content (a base64-encoded HTTP message) directly to Bing for a project's matched site, bypassing a crawl. FREE (no credits), but this is a MUTATION — unlike get_bing_site_overview, it queues real work on the operator's live Bing Webmaster account. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters5

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	Absolute URL of the page being submitted.
httpMessage	string	required	The page's full HTTP response, already base64-encoded by the caller — this tool does not encode it.
structuredData	string	optional	Optional structured-data payload Bing accepts alongside the content.
dynamicServing	string	optional	Optional dynamic-serving indicator Bing accepts alongside the content.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Absolute URL of the page being submitted."
    },
    "httpMessage": {
      "type": "string",
      "minLength": 1,
      "description": "The page's full HTTP response, already base64-encoded by the caller — this tool does not encode it."
    },
    "structuredData": {
      "description": "Optional structured-data payload Bing accepts alongside the content.",
      "type": "string"
    },
    "dynamicServing": {
      "description": "Optional dynamic-serving indicator Bing accepts alongside the content.",
      "type": "string"
    }
  },
  "required": [
    "projectId",
    "url",
    "httpMessage"
  ]
}

submit_bing_feed

SubmitFeed: submits a sitemap/feed URL to Bing for a project's matched site. FREE (no credits), but this is a MUTATION — unlike get_bing_site_overview, it queues real work on the operator's live Bing Webmaster account. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
feedUrl	string	required	Absolute URL of the sitemap/feed to submit.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "feedUrl": {
      "type": "string",
      "format": "uri",
      "description": "Absolute URL of the sitemap/feed to submit."
    }
  },
  "required": [
    "projectId",
    "feedUrl"
  ]
}

save_bing_crawl_settings

SaveCrawlSettings: overwrites a project's matched Bing site's crawl-rate/AJAX-crawling config. FREE (no credits), but this is a MUTATION — unlike get_bing_site_overview's GetCrawlSettings read, it writes to the operator's live Bing Webmaster account. crawlRate must have exactly 24 hourly values, per Bing's own documented CrawlSettings JSON sample. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
ajaxEnabled	boolean	required	Whether Bing should crawl AJAX content on this site.
crawlRate	array	required	Exactly 24 hourly crawl-rate values, one per hour of the day.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "ajaxEnabled": {
      "type": "boolean",
      "description": "Whether Bing should crawl AJAX content on this site."
    },
    "crawlRate": {
      "minItems": 24,
      "maxItems": 24,
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Exactly 24 hourly crawl-rate values, one per hour of the day."
    }
  },
  "required": [
    "projectId",
    "ajaxEnabled",
    "crawlRate"
  ]
}

update_bing_blocked_url

AddBlockedUrl + RemoveBlockedUrl: tell Bing to stop, or resume, showing one URL in search results for a project's matched site. FREE (no credits), but this is a MUTATION. There is no verified GetBlockedUrls to list current blocks with — add/remove-only. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters6

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
action	string	required	add: block this URL from search results. remove: undo a previous block.
url	string	required	The URL (or directory) to block/unblock.
entityType	any	required	0 = a single page, 1 = a directory.
requestType	any	required	0 = CacheOnly (keep out of the cache, still crawlable), 1 = full block.
date	string	optional	ISO-8601 date for the block. Defaults to now.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "action": {
      "type": "string",
      "enum": [
        "add",
        "remove"
      ],
      "description": "add: block this URL from search results. remove: undo a previous block."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL (or directory) to block/unblock."
    },
    "entityType": {
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ],
      "description": "0 = a single page, 1 = a directory."
    },
    "requestType": {
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ],
      "description": "0 = CacheOnly (keep out of the cache, still crawlable), 1 = full block."
    },
    "date": {
      "description": "ISO-8601 date for the block. Defaults to now.",
      "type": "string"
    }
  },
  "required": [
    "projectId",
    "action",
    "url",
    "entityType",
    "requestType"
  ]
}

update_bing_query_parameter

AddQueryParameter + RemoveQueryParameter + EnableDisableQueryParameter: add, remove, or toggle one query-string parameter Bing is told to ignore when canonicalizing URLs for a project's matched site. FREE (no credits), but this is a MUTATION. get_bing_site_overview's queryParameters field (GetQueryParameters) is the read half of this family. Bring-your-own-key: requires BING_WEBMASTER_API_KEY. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_site' when the project's domain has no verified match on the account.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
action	string	required	add: start ignoring this parameter. remove: stop ignoring it entirely. enable/disable: toggle an already-added rule without removing it.
parameter	string	required	The query-string parameter name, e.g. 'utm_source'.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "action": {
      "type": "string",
      "enum": [
        "add",
        "remove",
        "enable",
        "disable"
      ],
      "description": "add: start ignoring this parameter. remove: stop ignoring it entirely. enable/disable: toggle an already-added rule without removing it."
    },
    "parameter": {
      "type": "string",
      "minLength": 1,
      "description": "The query-string parameter name, e.g. 'utm_source'."
    }
  },
  "required": [
    "projectId",
    "action",
    "parameter"
  ]
}

list_bing_sites

Every site the caller's connected Bing Webmaster OAuth grant can access — the data source for picking which site to bind to a project (see set_bing_site). Live call to the Bing Webmaster API (GetUserSites) under the caller's OWN OAuth token, not the operator key. Read-only and FREE (no credits). Check `requiresReconnect` before treating an empty `sites` list as 'no sites': true means the stored grant can no longer reach Bing Webmaster.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_bing_site

Link (or repoint) a project's Bing Webmaster site. `siteUrl` is re-validated against the caller's LIVE site list on every call — fails if the site fell out of the connected account's access since it was last listed via list_bing_sites.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
siteUrl	string	required	Bing's own site URL string, taken verbatim from list_bing_sites.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "siteUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Bing's own site URL string, taken verbatim from list_bing_sites."
    }
  },
  "required": [
    "projectId",
    "siteUrl"
  ]
}

disconnect_bing

Unlink a project's Bing Webmaster site. Breaks Bing Webmaster data for every member of the organization, not just the caller — requires at least the admin role.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

submit_indexnow

Submit up to 10,000 of a project's own URLs to IndexNow (relayed to Bing, Yandex, Seznam and Naver) so they are re-crawled without waiting for the next scheduled crawl. FREE — no credits, no OAuth. Requires the project to have an IndexNow key set (PATCH /api/seo/projects/:projectId with { indexNowKey }) — the key it hosts at https://<domain>/<key>.txt. Every completed site-audit crawl also submits its own crawled URLs automatically, so this tool is for resubmitting specific URLs on demand (e.g. right after a manual publish), not the primary path. Every URL must be on the project's own domain — a mixed-host batch is rejected before any request reaches IndexNow.

Parameters2

projectId	string	required	Project id from list_projects.
urls	array	required	Absolute URLs to submit, all on the project's own domain.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "Project id from list_projects."
    },
    "urls": {
      "minItems": 1,
      "maxItems": 10000,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "description": "Absolute URLs to submit, all on the project's own domain."
    }
  },
  "required": [
    "projectId",
    "urls"
  ]
}

get_yandex_site_overview

Yandex's own view of a project's domain: the indexing summary — including the Site Quality Index (SQI), a third independent authority signal alongside OpenPageRank and Tranco — and popular search queries, read straight from the Yandex Webmaster API. FREE (no credits). Bring-your-own-token: requires the deployment operator to set YANDEX_WEBMASTER_OAUTH_TOKEN (one token covers every host verified on that Yandex account — no per-project connect step, and MisarSEO never drives the OAuth flow itself). Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_host' when the project's domain has no verified match on the account. Yandex publishes no backlink-lookup endpoint at all, so unlike get_bing_site_overview this has no backlinks section. `diagnostics` lists individually named issues (e.g. NO_SITEMAPS, DNS_ERROR) that `summary.siteProblems` only counts by severity.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
queryLimit	integer	optional	Max popular queries to return (1-500).

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "queryLimit": {
      "description": "Max popular queries to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "projectId"
  ]
}

reindex_yandex_url

Asks Yandex Webmaster to re-crawl one specific URL on a project's matched host. FREE (no credits), but this is a MUTATION — unlike get_yandex_site_overview, it queues real work on the operator's live Yandex Webmaster account and spends that account's daily recrawl quota. Bring-your-own-token: requires YANDEX_WEBMASTER_OAUTH_TOKEN. Answers { ok: false, reason: 'not_configured' } when unset, or 'no_matching_host' when the project's domain has no verified match on the account. Yandex's own documented failure cases — the URL already queued, or the account's recrawl quota already spent — surface as a normal tool error, not a 200 with ok:false.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
url	string	required	Absolute URL to re-crawl.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Absolute URL to re-crawl."
    }
  },
  "required": [
    "projectId",
    "url"
  ]
}

list_yandex_hosts

Every host the caller's connected Yandex Webmaster OAuth grant can access — the data source for picking which host to bind to a project (see set_yandex_host). Read-only and FREE (no credits). Check `requiresReconnect` before treating an empty `hosts` list as 'no hosts': true means the stored grant can no longer reach Yandex Webmaster.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_yandex_host

Link (or repoint) a project's Yandex Webmaster host. `hostId` is re-validated against the caller's LIVE host list on every call.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
hostId	string	required	Yandex's own composite protocol:domain:port host id, taken verbatim from list_yandex_hosts.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "hostId": {
      "type": "string",
      "minLength": 1,
      "description": "Yandex's own composite protocol:domain:port host id, taken verbatim from list_yandex_hosts."
    }
  },
  "required": [
    "projectId",
    "hostId"
  ]
}

disconnect_yandex

Unlink a project's Yandex Webmaster host. Breaks Yandex Webmaster data for every member of the organization, not just the caller — requires at least the admin role.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

get_baidu_connection

The project's current Baidu Webmaster (百度搜索资源平台) connection, plus today's push-quota usage. `today.lastRemain` is Baidu's own authoritative remaining-quota count as of the last push (null until the first push of the day) — `today.assumedDailyQuota` is a courtesy default only, never a real ceiling, since Baidu computes quota per-site dynamically and publishes no fixed number.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_baidu_connection

Set (or replace) a project's Baidu Webmaster site + push token. Baidu exposes no API to list or verify sites on an account, unlike Bing's GetUserSites — this stores the pair as given, with no live re-validation against Baidu. Requires the operator/user to have already verified the site on ziyuan.baidu.com and minted a push token there (Resource Submission -> Standard Inclusion -> API Submission).

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
siteUrl	string	required	Baidu's own `site` value, taken verbatim from ziyuan.baidu.com.
token	string	required	The site-specific push token minted on ziyuan.baidu.com AFTER completing Baidu's own site-ownership verification there — a real, external, one-time setup step this tool cannot automate.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "siteUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Baidu's own `site` value, taken verbatim from ziyuan.baidu.com."
    },
    "token": {
      "type": "string",
      "minLength": 6,
      "maxLength": 128,
      "description": "The site-specific push token minted on ziyuan.baidu.com AFTER completing Baidu's own site-ownership verification there — a real, external, one-time setup step this tool cannot automate."
    }
  },
  "required": [
    "projectId",
    "siteUrl",
    "token"
  ]
}

disconnect_baidu

Remove a project's Baidu Webmaster connection. Breaks Baidu push submission for every member of the organization, not just the caller — requires at least the admin role.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

submit_baidu_urls

Push a project's own URLs to Baidu (data.zz.baidu.com/urls) for expedited crawling. FREE (no credits), but this is a MUTATION that spends the project's real, Baidu-computed daily quota. Answers { ok: false, reason: 'not_connected' } when the project has no Baidu connection, 'quota_exceeded' (with the last-known remain) when today's quota is already spent, or 'site_not_verified' when Baidu reports the site/token pair as unverified — all as a normal result, never a thrown error, since these are expected operational states.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
urls	array	required	Absolute URLs to push to Baidu, up to 2000 per call.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "urls": {
      "minItems": 1,
      "maxItems": 2000,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "description": "Absolute URLs to push to Baidu, up to 2000 per call."
    }
  },
  "required": [
    "projectId",
    "urls"
  ]
}

list_ahrefs_projects

Every Rank Tracker AND Site Audit project the caller's connected Ahrefs Connect grant can access — the data source for picking which project(s) to bind to a MisarSEO project (see set_ahrefs_project). Live call to the Ahrefs API v3 under the caller's OWN OAuth token. Read-only and FREE (no credits). Check `requiresReconnect` before treating both lists as 'no projects': true means the stored grant can no longer reach Ahrefs.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

set_ahrefs_project

Bind (or repoint) ONE of a project's two independent Ahrefs project types — `projectType` selects `rank_tracker` or `site_audit`. `ahrefsProjectId` is re-validated against the caller's LIVE project list on every call — fails if the project fell out of the connected account's access since it was last listed via list_ahrefs_projects.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
projectType	string	required	Which of the two independent Ahrefs project types to bind.
ahrefsProjectId	string	required	Ahrefs' own project id, taken verbatim from list_ahrefs_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "projectType": {
      "type": "string",
      "enum": [
        "rank_tracker",
        "site_audit"
      ],
      "description": "Which of the two independent Ahrefs project types to bind."
    },
    "ahrefsProjectId": {
      "type": "string",
      "minLength": 1,
      "description": "Ahrefs' own project id, taken verbatim from list_ahrefs_projects."
    }
  },
  "required": [
    "projectId",
    "projectType",
    "ahrefsProjectId"
  ]
}

disconnect_ahrefs

Full disconnect: drops BOTH the Rank Tracker and Site Audit bindings and the stored grant. Breaks Ahrefs data for every member of the organization, not just the caller — requires at least the admin role.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

list_patches

Patches: every title/metaDescription/canonical/redirect fix drafted for a project, newest first, one active row per (page, field). FREE (no credits), read-only.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

draft_patch

Patches: drafts a title/metaDescription/canonical/redirect fix for one page's finding. FREE for canonical/redirect (deterministic — canonical is always the page's own URL, redirect always needs an explicit value); title/metaDescription cost one AI-gateway operation UNLESS `value` is given, which sets an explicit replacement instead of drafting one. This is a MUTATION — it creates or overwrites this page+field's draft, but does not publish it (use publish_patch for that). Requires an org admin.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
pageUrl	string	required	The exact crawled page URL this finding is on.
issueType	string	required	Which finding this patch addresses — determines the field (title/metaDescription/canonical/redirect).
value	string	optional	An explicit replacement value instead of AI-drafting one. Required for redirect (broken_page) — there is no computable default. Never used for canonical, which is always the page's own URL.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "pageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "The exact crawled page URL this finding is on."
    },
    "issueType": {
      "type": "string",
      "enum": [
        "missing_title",
        "title_too_long",
        "title_too_short",
        "missing_meta_description",
        "meta_description_too_long",
        "missing_canonical",
        "broken_page"
      ],
      "description": "Which finding this patch addresses — determines the field (title/metaDescription/canonical/redirect)."
    },
    "value": {
      "description": "An explicit replacement value instead of AI-drafting one. Required for redirect (broken_page) — there is no computable default. Never used for canonical, which is always the page's own URL.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "projectId",
    "pageUrl",
    "issueType"
  ]
}

batch_draft_patches

Patches: AI-drafts title AND metaDescription for up to 10 pages in one call. This is a MUTATION and costs one AI-gateway operation per field per page (up to 20) — never a bulk discount. One page/field failing is reported in that entry's own error without sinking the rest of the batch. Requires an org admin.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
pageUrls	array	required	1-10 crawled page URLs to draft title+metaDescription patches for.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "pageUrls": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "1-10 crawled page URLs to draft title+metaDescription patches for."
    }
  },
  "required": [
    "projectId",
    "pageUrls"
  ]
}

publish_patch

Patches: makes a drafted fix live — visible in the project's public manifest, which the embedded snippet (or, for redirects, an operator-deployed Worker) reads from the visitor's browser. The audited site's own origin content is never touched. FREE (no credits), but this is a MUTATION. Requires an org admin.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
patchId	string	required	The patch id, from list_patches or draft_patch.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "patchId": {
      "type": "string",
      "minLength": 1,
      "description": "The patch id, from list_patches or draft_patch."
    }
  },
  "required": [
    "projectId",
    "patchId"
  ]
}

revert_patch

Patches: stops serving a published fix — instant, since publishing only ever controlled visibility in the public manifest, never the audited site's own origin content. FREE (no credits), but this is a MUTATION. Requires an org admin.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
patchId	string	required	The patch id, from list_patches.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "patchId": {
      "type": "string",
      "minLength": 1,
      "description": "The patch id, from list_patches."
    }
  },
  "required": [
    "projectId",
    "patchId"
  ]
}

list_patch_auto_publish_rules

Patches: every issue type this project auto-publishes a freshly AI-drafted patch for, immediately on draft (capped at 20 auto-publishes per project per day). FREE (no credits), read-only.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

enable_patch_auto_publish

Patches: from now on, a freshly AI-drafted patch for this issue type publishes immediately instead of waiting for a manual publish_patch call — capped at 20 auto-publishes per project per day. A hand-typed replacement value (draft_patch's `value` argument) is NEVER auto-published regardless of this rule. FREE (no credits), but this is a MUTATION. Requires an org admin.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
issueType	string	required	Which finding type to auto-publish AI-drafted patches for.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "issueType": {
      "type": "string",
      "enum": [
        "missing_title",
        "title_too_long",
        "title_too_short",
        "missing_meta_description",
        "meta_description_too_long",
        "missing_canonical",
        "broken_page"
      ],
      "description": "Which finding type to auto-publish AI-drafted patches for."
    }
  },
  "required": [
    "projectId",
    "issueType"
  ]
}

disable_patch_auto_publish

Patches: stops auto-publishing freshly AI-drafted patches for this issue type — future drafts wait for a manual publish_patch call again. Already-published patches are unaffected. FREE (no credits), but this is a MUTATION. Requires an org admin.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
issueType	string	required	Which issue type's auto-publish rule to remove.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "issueType": {
      "type": "string",
      "enum": [
        "missing_title",
        "title_too_long",
        "title_too_short",
        "missing_meta_description",
        "meta_description_too_long",
        "missing_canonical",
        "broken_page"
      ],
      "description": "Which issue type's auto-publish rule to remove."
    }
  },
  "required": [
    "projectId",
    "issueType"
  ]
}

list_report_definitions

Lists a project's report definitions, each carrying `widgetCount`. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters1

projectId

string

required

Required. The MisarSEO project ID to scope this call to. Get one from list_projects.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    }
  },
  "required": [
    "projectId"
  ]
}

create_report_definition

Creates a report definition with a chosen set of widgets, in print order. Returns `{ id }`. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
name	string	required	Report name, 1-100 characters.
widgetTypes	array	required	Widget types, in print order. Catalogue: site_health (Crawl findings and issue counts from the latest audit.); internal_linking (Orphan pages, dead ends and link depth from the latest crawl.); rank_tracking (Rank-tracker scorecards per tracked domain.); keywords (Saved keywords with volume, difficulty and CPC.); search_console (Search Console totals and top queries/pages.); web_analytics (Sessions, pageviews and bounce rate from the tracking snippet.); gsc_coverage (How many of your pages Search Console has inspected, and their most common state.); rank_movers (Keywords that newly started ranking or climbed fast.); rank_volatility (How much your own positions churned between the last two checks.); share_of_voice (Your tracked domain's share of visibility against its competitors.); log_analyzer (Total server hits and the AI-crawler share of them.)

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Report name, 1-100 characters."
    },
    "widgetTypes": {
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "site_health",
          "internal_linking",
          "rank_tracking",
          "keywords",
          "search_console",
          "web_analytics",
          "gsc_coverage",
          "rank_movers",
          "rank_volatility",
          "share_of_voice",
          "log_analyzer"
        ]
      },
      "description": "Widget types, in print order. Catalogue: site_health (Crawl findings and issue counts from the latest audit.); internal_linking (Orphan pages, dead ends and link depth from the latest crawl.); rank_tracking (Rank-tracker scorecards per tracked domain.); keywords (Saved keywords with volume, difficulty and CPC.); search_console (Search Console totals and top queries/pages.); web_analytics (Sessions, pageviews and bounce rate from the tracking snippet.); gsc_coverage (How many of your pages Search Console has inspected, and their most common state.); rank_movers (Keywords that newly started ranking or climbed fast.); rank_volatility (How much your own positions churned between the last two checks.); share_of_voice (Your tracked domain's share of visibility against its competitors.); log_analyzer (Total server hits and the AI-crawler share of them.)"
    }
  },
  "required": [
    "projectId",
    "name",
    "widgetTypes"
  ]
}

get_report_definition

Gets a report definition's name and ordered widget types. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId"
  ]
}

rename_report_definition

Renames a report definition. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.
name	string	required	Report name, 1-100 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Report name, 1-100 characters."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId",
    "name"
  ]
}

delete_report_definition

Deletes a report definition. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId"
  ]
}

set_report_widgets

Replaces a report definition's whole widget list, in print order. Returns `{ widgetCount }`. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.
widgetTypes	array	required	Widget types, in print order. Catalogue: site_health (Crawl findings and issue counts from the latest audit.); internal_linking (Orphan pages, dead ends and link depth from the latest crawl.); rank_tracking (Rank-tracker scorecards per tracked domain.); keywords (Saved keywords with volume, difficulty and CPC.); search_console (Search Console totals and top queries/pages.); web_analytics (Sessions, pageviews and bounce rate from the tracking snippet.); gsc_coverage (How many of your pages Search Console has inspected, and their most common state.); rank_movers (Keywords that newly started ranking or climbed fast.); rank_volatility (How much your own positions churned between the last two checks.); share_of_voice (Your tracked domain's share of visibility against its competitors.); log_analyzer (Total server hits and the AI-crawler share of them.)

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    },
    "widgetTypes": {
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "site_health",
          "internal_linking",
          "rank_tracking",
          "keywords",
          "search_console",
          "web_analytics",
          "gsc_coverage",
          "rank_movers",
          "rank_volatility",
          "share_of_voice",
          "log_analyzer"
        ]
      },
      "description": "Widget types, in print order. Catalogue: site_health (Crawl findings and issue counts from the latest audit.); internal_linking (Orphan pages, dead ends and link depth from the latest crawl.); rank_tracking (Rank-tracker scorecards per tracked domain.); keywords (Saved keywords with volume, difficulty and CPC.); search_console (Search Console totals and top queries/pages.); web_analytics (Sessions, pageviews and bounce rate from the tracking snippet.); gsc_coverage (How many of your pages Search Console has inspected, and their most common state.); rank_movers (Keywords that newly started ranking or climbed fast.); rank_volatility (How much your own positions churned between the last two checks.); share_of_voice (Your tracked domain's share of visibility against its competitors.); log_analyzer (Total server hits and the AI-crawler share of them.)"
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId",
    "widgetTypes"
  ]
}

render_report_definition

Renders a report definition — fetches ONLY its selected widgets, not a fixed set. FREE: every widget is a local Postgres read, no upstream call, so this never spends a paid-provider credit or a live Search Console quota unit. `rank_volatility` and `share_of_voice` read the project's FIRST active rank tracker only; `rank_movers` sums across every active tracker.

Parameters3

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.
periodDays	any	optional	7, 28 or 90 days. Defaults to 28.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    },
    "periodDays": {
      "description": "7, 28 or 90 days. Defaults to 28.",
      "anyOf": [
        {
          "type": "number",
          "const": 7
        },
        {
          "type": "number",
          "const": 28
        },
        {
          "type": "number",
          "const": 90
        }
      ]
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId"
  ]
}

get_report_schedule

Gets a report definition's schedule, if it has one. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId"
  ]
}

upsert_report_schedule

Creates or replaces a report definition's schedule — the whole interval + recipient list, not individual fields. Requires the admin role in the calling organization, the same gate patch drafting/publishing uses, since this starts unattended recurring email delivery. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters4

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.
scheduleInterval	string	required	How often the report is re-sent.
recipientUserIds	array	required	Platform user IDs to email. Must be members of the calling organization — a non-member id is silently dropped. There is no arbitrary external-email recipient in this version; use list_team_members-style tooling to find teammate ids.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    },
    "scheduleInterval": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "description": "How often the report is re-sent."
    },
    "recipientUserIds": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Platform user IDs to email. Must be members of the calling organization — a non-member id is silently dropped. There is no arbitrary external-email recipient in this version; use list_team_members-style tooling to find teammate ids."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId",
    "scheduleInterval",
    "recipientUserIds"
  ]
}

delete_report_schedule

Deletes a report definition's schedule. Requires the admin role in the calling organization, same as creating one. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

projectId	string	required	Required. The MisarSEO project ID to scope this call to. Get one from list_projects.
reportDefinitionId	string	required	Report definition ID. Use list_report_definitions to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "Required. The MisarSEO project ID to scope this call to. Get one from list_projects."
    },
    "reportDefinitionId": {
      "type": "string",
      "minLength": 1,
      "description": "Report definition ID. Use list_report_definitions to find it."
    }
  },
  "required": [
    "projectId",
    "reportDefinitionId"
  ]
}

list_portfolios

Lists the caller organization's portfolios, each carrying `projectCount`. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_portfolio

Creates a portfolio. Returns `{ id }`. Starts with no member projects — use add_portfolio_projects next. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters1

name

string

required

Portfolio name, 1-100 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Portfolio name, 1-100 characters."
    }
  },
  "required": [
    "name"
  ]
}

get_portfolio

One card per member project (same shape get_dashboard returns — no GSC, no backlinks, see its own description for why) plus aggregate totals. `totals.averageHealthScore` is averaged over member projects that HAVE been audited, not over every member. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters1

portfolioId

string

required

Portfolio ID. Use list_portfolios to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "portfolioId": {
      "type": "string",
      "minLength": 1,
      "description": "Portfolio ID. Use list_portfolios to find it."
    }
  },
  "required": [
    "portfolioId"
  ]
}

rename_portfolio

Renames a portfolio. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

portfolioId	string	required	Portfolio ID. Use list_portfolios to find it.
name	string	required	Portfolio name, 1-100 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "portfolioId": {
      "type": "string",
      "minLength": 1,
      "description": "Portfolio ID. Use list_portfolios to find it."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Portfolio name, 1-100 characters."
    }
  },
  "required": [
    "portfolioId",
    "name"
  ]
}

delete_portfolio

Deletes a portfolio. Member projects themselves are untouched — only the grouping is removed. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters1

portfolioId

string

required

Portfolio ID. Use list_portfolios to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "portfolioId": {
      "type": "string",
      "minLength": 1,
      "description": "Portfolio ID. Use list_portfolios to find it."
    }
  },
  "required": [
    "portfolioId"
  ]
}

add_portfolio_projects

Adds projects to a portfolio. Returns `{ added }` — only ids that resolve to a project of the CALLER'S organization are added; any other id is silently dropped rather than erroring the whole call. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

portfolioId	string	required	Portfolio ID. Use list_portfolios to find it.
projectIds	array	required	MisarSEO project IDs. Use list_projects to find them.

Raw schema

{
  "type": "object",
  "properties": {
    "portfolioId": {
      "type": "string",
      "minLength": 1,
      "description": "Portfolio ID. Use list_portfolios to find it."
    },
    "projectIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "MisarSEO project IDs. Use list_projects to find them."
    }
  },
  "required": [
    "portfolioId",
    "projectIds"
  ]
}

remove_portfolio_projects

Removes projects from a portfolio. Succeeds whether or not an id was actually a member. FREE: database only, no SEO data provider is called and no credits are spent.

Parameters2

portfolioId	string	required	Portfolio ID. Use list_portfolios to find it.
projectIds	array	required	MisarSEO project IDs. Use list_projects to find them.

Raw schema

{
  "type": "object",
  "properties": {
    "portfolioId": {
      "type": "string",
      "minLength": 1,
      "description": "Portfolio ID. Use list_portfolios to find it."
    },
    "projectIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "MisarSEO project IDs. Use list_projects to find them."
    }
  },
  "required": [
    "portfolioId",
    "projectIds"
  ]
}

get_usage

Plan tier, credits remaining, and every quota/count dimension tracked against it for the caller's organization. FREE: reads counters this codebase already maintains for its own gating — nothing here calls a paid provider or spends a credit. `gatingActive` is false on a self-hosted deployment with no billing provider configured: `tier`, `creditsRemaining` and `quotas` are all null there, not a fabricated tier. `counts` (projects/rank-tracked keywords/API keys) is always populated. Inside a quota dimension, `used: null` means NOT TRACKED — an unlimited tier's counter is never incremented in the first place — never a real zero; `used: 0` IS a real measured zero. `aiGatewayOps` is the shared platform AI-gateway key's own monthly ceiling, reported separately because it is a platform-abuse ceiling, not a plan entitlement.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

README.md34 KBView on GitHub

MisarSEO MCP Server

Research keywords, track rankings, audit sites, monitor backlinks and AI-search visibility — from any AI assistant.

180 tools · 6 prompts · 3 resources · 6 agent skills

Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or Streamable HTTP.

Install

Smithery (recommended)

bash

npx -y @smithery/cli install misar/misarseo-mcp --client claude

Claude Code

bash

claude mcp add misarseo -- npx -y @misarseo/mcp@latest

Manual (any client)

json

{
  "mcpServers": {
    "misarseo": {
      "command": "npx",
      "args": ["-y", "@misarseo/mcp@latest"],
      "env": { "MISARSEO_API_KEY": "mseo_your_key_here" }
    }
  }
}

Ready-made configs for every client live in connectors/.

Remote (no install)

json

{
  "mcpServers": {
    "misarseo": {
      "type": "streamable-http",
      "url": "https://api.misar.io/seo/mcp",
      "headers": { "Authorization": "Bearer mseo_your_key_here" }
    }
  }
}

Authentication

Create an API key at https://seo.misar.io/ai (AI & MCP → create an API key) — it starts with mseo_ — and give it to the server in one of three ways: the MISARSEO_API_KEY environment variable, your MCP client's env block, or { "api_key": "mseo_…" } in ~/.misarseo/config.json.

Self-hosted instances: set MISARSEO_BASE_URL.

Tools

Tool	Description
`list_projects`	Lists the active projects in the user's organization.
`get_dashboard`	One card per active project in the caller's organization: latest audit health, rank-tracker status, and trailing-7-day web-analytics sessions.
`research_keywords`	Research keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call — one research run per seed.
`save_keywords`	Save keywords to a project's saved-keywords list.
`list_saved_keywords`	Lists keywords saved to a project, with whatever metrics have been cached for them (search volume, difficulty, CPC) and their tags.
`classify_keyword_intent`	Classify 1-200 keywords' search intent from their wording: informational, navigational, commercial, transactional, or unknown.
`get_keyword_potential`	Parent Topic and Traffic Potential for one keyword, built from real SERP overlap across a BOUNDED set (up to 5) of related keywords — not a full keyword-to-URL reverse index, which this codebase's free stack does not have.
`get_keyword_serp_overview`	Per-keyword SERP overview: a fresh live SERP snapshot for the keyword, PLUS — when this exact keyword happens to already be tracked in this project's rank tracking — its historical position trend and SERP volatility, read straight from the SAME rank-tracking services (`get_rank_keyword_history`/`get_rank_volatility_index`) already use.
`get_keyword_strategy`	Keyword Strategy Builder: a volume -> cluster -> page -> brief pipeline over 1-500 pasted keywords, composed entirely from existing pieces — the same bulk keyword lookup, the same shared-phrase clustering engine the saved-keyword Topic Clusters feature and get_topic_research both already use, a text-match against the project's own crawled pages, and a BOUNDED number of AI-gateway content-brief calls (one per cluster among the top few by measured volume, gated by the shared AI-gateway budget).
`get_topic_research`	Content ideas for a seed keyword, composed from three sources this codebase already fetches for other features: the SERP for the seed (titles of pages already ranking for it), PAA-style questions (real autocomplete completions reframed as questions), and autocomplete keyword suggestions.
`get_keyword_list_share_of_voice`	Share of Voice across a saved keyword list: the project's own domain plus up to 3 competitor domains, scored over a saved-keyword tag ("a saved keyword list" in this codebase IS a saved-keyword tag — omit tagId/tagName to mean every saved keyword in the project).
`get_domain_overview`	Returns a high-level view of a domain's organic footprint: estimated organic traffic, organic keyword count, and a 0-100 domain authority score.
`get_domain_batch`	Domain batch analysis: one authority row per domain, up to 100 at once.
`get_domain_authority_history`	Domain-authority history: the stored trend of dated authority snapshots for one project+domain, oldest first.
`capture_domain_authority_snapshot`	Capture a domain-authority snapshot now: calls the same free resolver get_domain_overview already uses and records today's reading, so get_domain_authority_history has a trend to read back.
`find_serp_competitors`	Compares domains competing in search results for a supplied keyword set.
`get_keyword_gap`	Compares the project's own domain against up to 3 competitor domains and classifies every keyword a competitor ranks for as missing / behind / tied / ahead / unknown.
`list_competitor_monitors`	Competitor page change detection: the specific competitor URLs monitored for a project, with `lastCheckedAt` (null until the first scheduled check reaches it).
`add_competitor_monitor`	Start monitoring one competitor page for changes: title/meta, a real line-level content diff (added/removed/unchanged line counts — never a fabricated similarity score), outbound links, and structured-data types.
`remove_competitor_monitor`	Stops monitoring one competitor URL.
`get_competitor_monitor_changes`	Timeline of DETECTED changes for one monitored competitor URL, newest first — a check that found nothing does not appear here.
`get_rank_tracker`	Read-only access to rank tracker configs and their latest results.
`add_rank_tracking_keywords`	Adds keywords to an existing rank tracker config.
`get_rank_config_trend`	Per-run keyword-position-distribution buckets for a tracker, oldest first — how many tracked keywords sit in the top 3, 4-10, 11-20, or outside the top 20, per check run.
`get_rank_movers`	Newcomers and fast climbers for a tracker's OWN domain, over a window.
`get_rank_keyword_history`	Per-keyword position series over time, oldest first — the same series the app's SERP-history chart draws for one tracked keyword.
`get_rank_volatility_index`	SERP volatility index across recent runs — how much this tracker's own positions churned run over run, derived entirely from already-stored history (no new SERP calls).
`get_rank_ai_overview_trend`	AI Overview presence trend across a tracker's keywords, oldest first — what share of tracked keywords showed Google's AI Overview in the SERP, per check run, and how that has moved over time.
`list_rank_annotations`	Chart notes on a rank tracker's own timeline — 'deployed new title tags', 'algorithm update' — oldest first.
`add_rank_annotation`	Adds a chart note to a rank tracker's own timeline.
`remove_rank_annotation`	Removes a chart note from a rank tracker's own timeline.
`list_rank_cannibalisation`	Tracked keywords whose latest ranking URL is not the target URL you declared for them (see set_rank_keyword_target_url).
`set_rank_keyword_target_url`	Sets or clears the URL you intend to rank for a tracked keyword.
`list_rank_keyword_tags`	Lists the tags in use on one rank tracker, plus the project's whole tag vocabulary.
`update_rank_keyword_tag`	Attaches or detaches ONE tag across a selection of tracked keywords (up to 500 keyword IDs per call).
`get_brave_search_rank_check`	Checks where a project's domain (or an explicit targetDomain) ranks in REAL Brave Search results for one keyword.
`create_rank_tracker`	Creates a rank tracker config (domain + market + devices + schedule) for a project and returns its configId.
`list_rank_tracking_keywords`	Lists the keywords tracked by ONE rank tracker: `{ keywords, totalCount, page, pageSize }`, each row `{ id, configId, keyword, searchVolume, keywordDifficulty, cpc, metricsFetchedAt, createdAt }`.
`remove_rank_tracking_keywords`	Removes keywords from a rank tracker by their tracking-keyword IDs (from list_rank_tracking_keywords).
`start_site_audit`	Starts a MisarSEO site crawl/audit from startUrl.
`get_site_audit_status`	Progress of a site audit started by start_site_audit: `{ status, pagesCrawled, pagesTotal, lighthouseTotal, lighthouseCompleted, lighthouseFailed, currentPhase, startedAt, completedAt }`.
`get_audit_comparison`	Compare a site audit against an earlier one: which issues are new, which were fixed, how many persist, and the health-score delta.
`get_audit_core_web_vitals`	Core Web Vitals report: LCP/INP/CLS per page/strategy this audit already ran Lighthouse against, classified against Google's own published thresholds.
`get_audit_https_report`	HTTPS Report: percentage of pages secure, mixed-content and insecure-link counts, homepage HTTPS-path status, and HTTP URLs in an HTTPS site's sitemap — for a project's latest completed crawl (or a named earlier one).
`get_audit_internal_links`	Internal Link Report: outbound/inbound internal link counts per page, orphan pages, dead ends, and click-depth distribution for a project's latest completed crawl (or a named earlier one).
`get_audit_structured_data`	Structured Data Report: pages grouped by schema.org @type, which pages have none, and which pages carry an unparseable JSON-LD block — for a project's latest completed crawl (or a named earlier one).
`get_search_console_performance`	Query the connected Search Console property's Search Analytics: clicks, impressions, CTR, and average position by query/page/country/device/date.
`inspect_urls`	Run Google Search Console's URL Inspection on up to 10 URLs of the connected property: index/coverage state, last crawl time, Google-selected vs declared canonical, and mobile/rich-results verdicts.
`get_search_console_coverage`	MisarSEO's own index-coverage report for the connected property: which URLs are indexed, excluded, or errored, and why.
`get_search_console_hourly_performance`	MisarSEO's own retained HOURLY Search Console totals for the connected property — the hourly counterpart to get_search_console_performance's daily archive.
`get_search_console_sitemaps`	Search Console sitemaps.list/sitemaps.get: every sitemap submitted for the connected property and its processing status (pending, last downloaded, warning/error counts, per-content-type submitted counts), or one named sitemap.
`get_gsc_ctr_by_position`	CTR by ranking position: the site's own historical Search Console clicks/impressions bucketed by position (1-3, 4-10, 11-20, 21+ — mirroring this codebase's existing rank-tracking position-distribution buckets), with the REAL clicks-weighted CTR this project achieved at each bucket.
`get_gsc_anonymous_queries`	Anonymized-query estimate: Search Console omits some rare queries entirely from a query-dimensioned response to protect searcher privacy (Google's own documented behaviour, not this codebase's assumption).
`get_cannibalisation_report`	Finds the queries where the project's connected Search Console property competes with itself: two or more of its own pages drawing impressions for the same query, splitting that query's clicks, click signals and ranking history across URLs.
`get_content_decay_report`	Finds pages whose clicks declined by a meaningful amount between two adjacent windows, read entirely from MisarSEO's own archived Search Console history (the top-200-per-day per-page archive the nightly sync fills in).
`get_backlinks_overview`	Returns a backlinks profile summary (total backlinks, referring domains, referring pages, rank) plus the top referring domains by backlink count.
`get_link_intersect`	Finds the domains that link to 2–4 of the project's competitors but NOT to the project itself.
`list_disavow_entries`	Disavow file management: every disavow entry for a project, oldest first.
`add_disavow_entry`	Disavow file management: mark one URL or domain for disavowal.
`remove_disavow_entry`	Disavow file management: remove one disavow entry by id (from list_disavow_entries).
`export_disavow_file`	Disavow file management: export a project's disavow entries as the exact .txt content Google's disavow tool accepts (support.google.com/webmasters/answer/2648487) — one bare URL per line to disavow that exact page, or `domain:<host>` to disavow an entire domain and its subdomains.
`get_backlink_anchors`	Anchor-text distribution for a domain or URL, one page at a time: which anchor texts link to it, with backlinks, referring domains, referring pages and dofollow links per anchor.
`get_content_optimizer_report`	On-page recommendations and an AI content grade for one page, benchmarked against the pages currently ranking for its target keyword, built together — one AI-gateway call produces both the grade and the recommendations).
`get_content_page_metrics`	Lightweight on-page metrics for one arbitrary URL — the content optimizer's keyword-free, AI-free sibling.
`run_brand_radar_scan`	Scans real AI-answer engines and search citations for brand mentions, Share of Voice against named competitors, and cited sources.
`get_brand_radar_scan_status`	Status of a Brand Radar scan started by run_brand_radar_scan, by its `jobId`.
`explore_ai_prompt`	Runs one prompt through up to 4 model personas and returns each answer verbatim, with real citations when webSearch is on.
`research_ai_prompts`	Turns a seed topic into candidate prompts worth tracking (real Google/Bing autocomplete completions reframed as questions) plus observed mention-rate signals from this project's own already-tracked prompts.
`compare_ai_competitor_positioning`	Runs ONE prompt through the explore_ai_prompt pipeline and checks a brand plus its named competitors against the SAME real per-model answers for mentions and citations.
`get_direct_vendor_answers`	Runs a prompt against up to 5 REAL, directly-verified vendor models — you_com (You.com Answer API), deepseek, grok (xAI), meta_ai (Meta's Model API) and minimax — each called through that vendor's own public API.
`get_brand_scan_trend`	The recorded AI-visibility history for one brand or domain: mentions, cited sources and competitors seen at each past Brand Radar scan, oldest first.
`list_brand_monitors`	Lists a project's brand monitors — targets re-scanned by Brand Radar on a schedule rather than only when run_brand_radar_scan is called.
`upsert_brand_monitor`	Creates or replaces a brand monitor — the whole schedule and competitor list, not single fields.
`delete_brand_monitor`	Deletes a brand monitor, stopping its scheduled scans.
`list_tracked_prompts`	Lists a project's tracked prompts — prompts re-run through explore_ai_prompt's real answer pipeline on a schedule and diffed against the previous check for mention/citation drops.
`upsert_tracked_prompt`	Creates or replaces a tracked prompt — the whole model list and schedule, not single fields.
`delete_tracked_prompt`	Deletes a tracked prompt, stopping its scheduled checks.
`get_tracked_prompt_trend`	Observed history for one tracked prompt — one point per real scheduled check (`mentionedByCount`/`citedByCount` out of `successfulModelCount`), oldest first.
`get_unlinked_mentions_report`	Unlinked brand mentions: searches the free SERP backend for `brand` as a QUERY, then checks whether each result page already links to `trackedDomain`.
`get_media_monitoring_report`	Media Monitoring: get_unlinked_mentions_report's candidates filtered to known social/forum/news platform domains, optionally merged with the citation-platform breakdown from a Prompt Explorer scan you already ran for the same brand.
`search_local_businesses`	Searches local business listings near a coordinate.
`get_google_business_questions`	Fetches question-and-answer rows for one business keyword.
`run_local_nap_audit`	Compare a claimed business Name/Address/Phone against listings the free OpenStreetMap business search finds near the claimed location.
`get_local_pack_rank`	Read-only access to local pack rank check configs and their latest check.
`get_local_rank_grid`	Read-only access to geo-grid rank-tracking configs and their latest run.
`get_gbp_profile`	Read-only Google Business Profile listing profile for the project's linked location: title, categories, phone, website, description, hours-period count, and which of Google's attribute taxonomy entries are set.
`get_gbp_performance`	Read-only Business Profile Performance API metrics for the project's linked location over an inclusive date range.
`get_gbp_reviews`	Read-only reviews for the project's linked Google Business Profile location, one Google-paginated page at a time..
`reply_to_gbp_review`	Reply to (or overwrite the reply on) one review, by reviewId from get_gbp_reviews.
`get_gbp_optimization`	Completeness/quality score and AI-grounded optimization recommendations for the project's linked Google Business Profile location.
`list_gbp_locations`	Every Google Business Profile account and location this deployment's operator credential can manage — the picker data for set_gbp_connection.
`get_gbp_connection`	The project's currently linked Google Business Profile location, or `{ connection: null }` when none is linked yet.
`set_gbp_connection`	Links (or repoints) a project to a Google Business Profile location.
`disconnect_gbp`	Removes the project's link to its Google Business Profile location.
`list_gbp_posts`	Posts published on the project's linked Google Business Profile location.
`create_gbp_post`	Publishes a new "What's New" post on the linked Google Business Profile location.
`delete_gbp_review_reply`	Removes the owner's published reply from one Google review (reviewId from get_gbp_reviews).
`create_local_pack_rank_config`	Creates a local pack rank check config: where businessName sits in Google's local pack for one keyword at one location.
`delete_local_pack_rank_config`	Deletes a local pack rank check config, INCLUDING its whole check history.
`run_local_pack_rank_check`	Runs a local pack rank check now — one live scrape of Google's public local search results (not the paid Places API).
`create_local_rank_grid_config`	Creates a geo-grid rank-tracking config: a 3x3 grid of points around a centre coordinate, checking ORGANIC rank for one keyword and domain from each point.
`delete_local_rank_grid_config`	Deletes a geo-grid rank-tracking config, INCLUDING its whole run and point history.
`run_local_rank_grid`	Runs a geo-grid rank check now — up to 9 live SERP calls plus up to 9 reverse-geocode calls.
`get_web_analytics_summary`	Sessions/pageviews/bounce-rate time series for a project's own tracking snippet.
`get_web_analytics_top_pages`	Top pages by view count, plus separate entry-page and exit-page breakdowns, for a project's own tracking snippet.
`get_web_analytics_sources`	Referrer/channel/UTM breakdown for a project's own tracking snippet, including AI referral attribution: aiReferral.bySource breaks the ai-referral channel out by assistant (chatgpt/claude/perplexity/gemini/copilot/you/poe).
`get_web_analytics_devices`	Device/browser/OS breakdown for a project's own tracking snippet.
`list_ga4_properties`	Every GA4 property the caller's connected Google Analytics grant can access — the data source for picking which property to bind to a project (see set_ga4_property).
`set_ga4_property`	Link (or repoint) a project's Google Analytics property.
`disconnect_ga4`	Unlink a project's Google Analytics property.
`get_ga4_performance_summary`	MisarSEO's own retained daily Google Analytics totals for the connected property: sessions, activeUsers, newUsers, engagementRate, bounceRate, conversions, screenPageViews.
`get_ga4_channel_breakdown`	MisarSEO's own retained daily GA4 channel breakdown (sessionDefaultChannelGroup) for the connected property — isolating Organic Search from every other acquisition channel, the SEO-relevant signal GA4 adds beyond Search Console's own click/impression data.
`get_ga4_landing_pages`	MisarSEO's own retained daily GA4 landing-page breakdown for the connected property: sessions/engagement/conversions per landing page, ordered by sessions descending within each day.
`log_analyzer_list_uploads`	A project's server-log uploads and their parse status — the Log File Analyzer / Bot Analytics feature.
`log_analyzer_upload`	Upload a server access log for background parsing (Log File Analyzer / Bot Analytics).
`log_analyzer_daily_summary`	Bot hit counts per (day, bot category, bot label, status code, content-type bucket) across every log upload in the date range — powers a time-series, status-code, or content-type view of bot traffic.
`log_analyzer_top_paths`	The paths bots hit most, per (bot category, bot label, path, status code) — the busiest-paths table of Bot Analytics.
`list_link_prospects`	Link Building Tool: every prospect for a project, newest first, each enriched with a LIVE domain-authority read (never cached, never an invented score).
`add_link_prospect`	Link Building Tool: add one prospect domain/page to a project's list.
`update_link_prospect`	Link Building Tool: edit a prospect's editable fields (url/label/targetUrl/contact fields) — only fields given here are changed.
`update_link_prospect_status`	Link Building Tool: move a prospect through the outreach-status pipeline — prospected -> contacted -> replied -> link_placed/declined/no_response ('declined'/'no_response' can loop back to 'contacted' for a re-approach).
`remove_link_prospect`	Link Building Tool: remove one prospect by id (from list_link_prospects), along with its activity log.
`list_link_prospect_activity`	Link Building Tool: a prospect's activity log — every manually-typed note plus every auto-recorded status change, newest first.
`add_link_prospect_note`	Link Building Tool: add one manual activity-log entry to a prospect, e.g.
`import_link_prospects_csv`	Link Building Tool: bulk-add up to 500 prospects at once from already-parsed rows (each with at least a domain).
`export_link_prospects_csv`	Link Building Tool: export a project's prospect list as CSV text.
`get_bing_site_overview`	Bing's own view of a project's domain: daily search performance (clicks/impressions), per-query stats, own-site inbound links, remaining URL Submission quota, crawl diagnostics (crawl stats, crawl issues, crawl settings), submitted feeds and query-parameter settings — read straight from the Bing Webmaster API.
`get_bing_backlinks`	GetLinkCounts: own-site inbound-link page list for a project's matched Bing site — the focused, single-call form of the backlinks field already embedded in get_bing_site_overview.
`get_bing_url_links`	GetUrlLinks: the inbound links (anchor text + source URL) pointing at one specific page on a project's matched Bing site, read straight from the Bing Webmaster API.
`get_bing_url_info`	GetUrlInfo + optionally GetChildrenUrlInfo: index/crawl metadata (anchor count, discovery/last-crawled dates, HTTP status, whether Bing considers it a page) for one URL on a project's matched Bing site, and, when includeChildren is set, the same metadata for every URL Bing discovered under it.
`get_bing_keyword_research`	GetKeyword + GetKeywordStats + GetRelatedKeywords: real Bing impression data for a query, its recent weekly history, and related queries — read straight from the Bing Webmaster API.
`get_bing_detail_stats`	GetQueryTrafficStats + GetPageStats + GetPageQueryStats + GetQueryPageStats + GetQueryPageDetailStats: per-query and per-page search-performance detail for a project's matched Bing site.
`get_bing_feed_details`	GetFeedDetails: the same Feed shape as one entry from Bing's GetFeeds list, for one specific feed URL on a project's matched site.
`submit_bing_content`	SubmitContent: pushes a page's full content (a base64-encoded HTTP message) directly to Bing for a project's matched site, bypassing a crawl.
`submit_bing_feed`	SubmitFeed: submits a sitemap/feed URL to Bing for a project's matched site.
`save_bing_crawl_settings`	SaveCrawlSettings: overwrites a project's matched Bing site's crawl-rate/AJAX-crawling config.
`update_bing_blocked_url`	AddBlockedUrl + RemoveBlockedUrl: tell Bing to stop, or resume, showing one URL in search results for a project's matched site.
`update_bing_query_parameter`	AddQueryParameter + RemoveQueryParameter + EnableDisableQueryParameter: add, remove, or toggle one query-string parameter Bing is told to ignore when canonicalizing URLs for a project's matched site.
`list_bing_sites`	Every site the caller's connected Bing Webmaster OAuth grant can access — the data source for picking which site to bind to a project (see set_bing_site).
`set_bing_site`	Link (or repoint) a project's Bing Webmaster site.
`disconnect_bing`	Unlink a project's Bing Webmaster site.
`submit_indexnow`	Submit up to 10,000 of a project's own URLs to IndexNow (relayed to Bing, Yandex, Seznam and Naver) so they are re-crawled without waiting for the next scheduled crawl.
`get_yandex_site_overview`	Yandex's own view of a project's domain: the indexing summary — including the Site Quality Index (SQI), a third independent authority signal alongside OpenPageRank and Tranco — and popular search queries, read straight from the Yandex Webmaster API.
`reindex_yandex_url`	Asks Yandex Webmaster to re-crawl one specific URL on a project's matched host.
`list_yandex_hosts`	Every host the caller's connected Yandex Webmaster OAuth grant can access — the data source for picking which host to bind to a project (see set_yandex_host).
`set_yandex_host`	Link (or repoint) a project's Yandex Webmaster host.
`disconnect_yandex`	Unlink a project's Yandex Webmaster host.
`get_baidu_connection`	The project's current Baidu Webmaster (百度搜索资源平台) connection, plus today's push-quota usage.
`set_baidu_connection`	Set (or replace) a project's Baidu Webmaster site + push token.
`disconnect_baidu`	Remove a project's Baidu Webmaster connection.
`submit_baidu_urls`	Push a project's own URLs to Baidu (data.zz.baidu.com/urls) for expedited crawling.
`list_ahrefs_projects`	Every Rank Tracker AND Site Audit project the caller's connected Ahrefs Connect grant can access — the data source for picking which project(s) to bind to a MisarSEO project (see set_ahrefs_project).
`set_ahrefs_project`	Bind (or repoint) ONE of a project's two independent Ahrefs project types — `projectType` selects `rank_tracker` or `site_audit`.
`disconnect_ahrefs`	Full disconnect: drops BOTH the Rank Tracker and Site Audit bindings and the stored grant.
`list_patches`	Patches: every title/metaDescription/canonical/redirect fix drafted for a project, newest first, one active row per (page, field).
`draft_patch`	Patches: drafts a title/metaDescription/canonical/redirect fix for one page's finding.
`batch_draft_patches`	Patches: AI-drafts title AND metaDescription for up to 10 pages in one call.
`publish_patch`	Patches: makes a drafted fix live — visible in the project's public manifest, which the embedded snippet (or, for redirects, an operator-deployed Worker) reads from the visitor's browser.
`revert_patch`	Patches: stops serving a published fix — instant, since publishing only ever controlled visibility in the public manifest, never the audited site's own origin content.
`list_patch_auto_publish_rules`	Patches: every issue type this project auto-publishes a freshly AI-drafted patch for, immediately on draft (capped at 20 auto-publishes per project per day).
`enable_patch_auto_publish`	Patches: from now on, a freshly AI-drafted patch for this issue type publishes immediately instead of waiting for a manual publish_patch call — capped at 20 auto-publishes per project per day.
`disable_patch_auto_publish`	Patches: stops auto-publishing freshly AI-drafted patches for this issue type — future drafts wait for a manual publish_patch call again.
`list_report_definitions`	Lists a project's report definitions, each carrying `widgetCount`.
`create_report_definition`	Creates a report definition with a chosen set of widgets, in print order.
`get_report_definition`	Gets a report definition's name and ordered widget types.
`rename_report_definition`	Renames a report definition.
`delete_report_definition`	Deletes a report definition.
`set_report_widgets`	Replaces a report definition's whole widget list, in print order.
`render_report_definition`	Renders a report definition — fetches ONLY its selected widgets, not a fixed set.
`get_report_schedule`	Gets a report definition's schedule, if it has one.
`upsert_report_schedule`	Creates or replaces a report definition's schedule — the whole interval + recipient list, not individual fields.
`delete_report_schedule`	Deletes a report definition's schedule.
`list_portfolios`	Lists the caller organization's portfolios, each carrying `projectCount`.
`create_portfolio`	Creates a portfolio.
`get_portfolio`	One card per member project (same shape get_dashboard returns — no GSC, no backlinks, see its own description for why) plus aggregate totals.
`rename_portfolio`	Renames a portfolio.
`delete_portfolio`	Deletes a portfolio.
`add_portfolio_projects`	Adds projects to a portfolio.
`remove_portfolio_projects`	Removes projects from a portfolio.
`get_usage`	Plan tier, credits remaining, and every quota/count dimension tracked against it for the caller's organization.

Prompts

Reusable workflows your client exposes as slash-commands.

Prompt	Description
`keyword_research_plan`	Research a seed topic, qualify the keywords by intent and potential, and save a shortlist.
`competitor_gap_analysis`	Find the keywords and linking domains competitors have that the project does not.
`site_audit_review`	Turn the latest site audit into a prioritised technical fix list.
`search_console_opportunities`	Mine Search Console for striking-distance queries, cannibalisation and decaying pages.
`ai_visibility_check`	Check how a brand shows up in AI answers and where it is mentioned without a link.
`weekly_rank_report`	Produce a stakeholder-ready weekly rank-tracking summary.

Resources

Read-only context an agent can attach without spending a tool call.

URI	Description
`misarseo://projects`	The organization's active MisarSEO projects with their ids and domains.
`misarseo://dashboard`	One card per project: latest audit health, rank-tracker status and trailing-7-day web-analytics sessions.
`misarseo://account/usage`	Plan tier, credits remaining, and each quota (keyword lookups, audits, Brand Radar scans, log uploads) with what is used.

Agent skills

Bundled in skills/ — guidance an agent loads when a task matches.

Skill	Use when
`ai-search-visibility`	Measure how a brand appears in AI answers and AI-search citations with MisarSEO — Brand Radar share of voice, prompt exploration, prompt research and unlinked mentions. Use for "are we showing up in ChatGPT", "AI search visibility", "GEO", "LLM mentions", "AI Overviews", or brand-mention questions.
`competitor-gap-analysis`	Compare a MisarSEO project against competitors — keyword gap, SERP competitors, link intersect and competitor page-change monitoring. Use for "who are my competitors", "what keywords am I missing", "where do competitors get links", or "watch this competitor's page".
`keyword-research`	Research, qualify and save keywords in MisarSEO — volume, difficulty, intent, traffic potential and topic clusters. Use for "find keywords for…", "what should we target", "keyword ideas", "is this keyword worth it", or building a content plan from a seed topic.
`rank-tracking-report`	Report on and organise MisarSEO rank tracking — positions, visibility trend, movers, volatility, wrong-page rankings, chart notes and keyword tags. Use for "how are my rankings", "weekly rank report", "what moved", "track these keywords", or "which page ranks for this keyword".
`search-console-insights`	Turn Google Search Console data in MisarSEO into actions — striking-distance queries, keyword cannibalisation, decaying pages, real CTR by position and indexing gaps. Use for "what's my search traffic doing", "quick SEO wins", "why did traffic drop", "pages competing with each other", or anything mentioning Search Console / GSC.
`technical-site-audit`	Read a MisarSEO site audit and turn it into a ranked technical fix list — HTTPS, internal links, structured data, Core Web Vitals, indexing — and optionally ship title/meta fixes as patches. Use for "audit my site", "technical SEO issues", "why isn't this page indexed", "orphan pages", or "fix my titles".

Safety

Destructive and irreversible actions are annotated (destructiveHint) so clients can prompt before running them. The skills instruct agents to confirm before anything that sends mail, publishes content, or is otherwise visible to other people.

Discovery (initialize, tools/list, prompts/list, resources/list) never requires credentials, so registries can index the server without one. Every action does.

Install

Tools (180)

list_projectsget_dashboardresearch_keywordssave_keywordslist_saved_keywordsclassify_keyword_intentget_keyword_potentialget_keyword_serp_overview

Configuration

Environment variables

MISARSEO_API_KEYsecret

Your MisarSEO API key (mseo_…). Create one at https://seo.misar.io/ai.

MISARSEO_BASE_URL

Override the API base URL. Only needed for self-hosted instances.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "misarseo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@misarseo/mcp@1.0.0"
      ],
      "env": {
        "MISARSEO_API_KEY": "<YOUR_MISARSEO_API_KEY>",
        "MISARSEO_BASE_URL": "<YOUR_MISARSEO_BASE_URL>"
      }
    }
  }
}