MCP Server
Tools
The full tool catalogue for both MisarSEO MCP servers — 18 hosted tools and 16 stdio tools.
MisarSEO ships two MCP servers with separate tool catalogues. Check which server you connected to before writing prompts against these names — see MCP Server for setup.
Hosted server — 18 tools
Served at https://seo.misar.io/mcp over streamable HTTP. Tool names are bare verbs, no prefix.
| Tool | Purpose | Charges credits |
|---|---|---|
whoami | Identify the authenticated caller and organization. Useful as a connection check. | No |
list_projects | List projects. Call this first — nearly every other tool needs a projectId. | No |
list_saved_keywords | Read a project's saved keyword set. | No |
research_keywords | Fetch live metrics and expansions for a keyword list. | Yes |
save_keywords | Persist keywords to a project's saved set. | No |
get_domain_overview | Authority, traffic, and visibility metrics for a domain. | Yes |
get_domain_keyword_suggestions | Keyword ideas derived from a domain. | Yes |
get_backlinks_overview | Link-profile metrics for a domain or page. | Yes |
get_serp_results | Raw search results for a query. | Yes |
get_rank_tracker | Read a rank-tracking configuration. | No |
get_ranked_keywords | Keywords a domain currently ranks for. | Yes |
find_serp_competitors | Domains competing across a keyword set. | Yes |
search_local_businesses | Businesses within a radius of a point. | Yes |
get_local_serp_results | Location-scoped search results. | Yes |
get_google_business_questions | Google Business Q&A for a local term. | Yes |
get_keyword_metrics | Volume, CPC, and difficulty for specific keywords. | Yes |
get_search_console_performance | Search Console performance rows. | No |
inspect_urls | Search Console URL inspection, up to 50 URLs. | No |
Local stdio server — 16 tools
Provided by @misar/seo-mcp. Tool names carry a seo_ prefix.
| Tool | Purpose | Charges credits |
|---|---|---|
seo_list_projects | List projects. Call this first to obtain a projectId. | No |
seo_keyword_research | Expand seeds into keyword ideas with volume, difficulty, and CPC. | Yes |
seo_saved_keywords_list | Read a project's saved keyword set. | No |
seo_saved_keywords_save | Persist keywords to the saved set. | No |
seo_crawl_site | Start a site audit crawl. | Yes |
seo_get_crawl_results | Fetch crawl and audit results. | No |
seo_rank_check | Run or read a rank check. | Yes |
seo_rank_tracker_create | Create a rank-tracking configuration. | No |
seo_rank_keywords_add | Add keywords to a tracking configuration. | No |
seo_rank_keywords_remove | Remove tracked keywords from a configuration. | No |
seo_domain_overview | Aggregate metrics for a domain. | Yes |
seo_backlinks | Link-profile metrics for a domain or page. | Yes |
seo_competitors | Competitor discovery across a keyword set. | Yes |
seo_ai_radar | AI brand-radar scan. Enqueued asynchronously. | Yes |
seo_prompt_explorer | Run a prompt against AI models and compare answers. | Yes |
seo_gsc_data | Query Search Console performance. | No |
What each catalogue covers
| Capability | Hosted | stdio |
|---|---|---|
| Projects | list_projects | seo_list_projects |
| Site audit / crawl | — | seo_crawl_site, seo_get_crawl_results |
| Keyword research | research_keywords, get_keyword_metrics, get_domain_keyword_suggestions | seo_keyword_research |
| Saved keywords | list_saved_keywords, save_keywords | seo_saved_keywords_list, seo_saved_keywords_save |
| Rank tracking | get_rank_tracker, get_ranked_keywords | seo_rank_check, seo_rank_tracker_create, seo_rank_keywords_add, seo_rank_keywords_remove |
| Domain metrics | get_domain_overview | seo_domain_overview |
| Backlinks | get_backlinks_overview | seo_backlinks |
| Competitors | find_serp_competitors | seo_competitors |
| SERP | get_serp_results, get_local_serp_results | — |
| Local | search_local_businesses, get_google_business_questions | — |
| AI search | — | seo_ai_radar, seo_prompt_explorer |
| Search Console | get_search_console_performance, inspect_urls | seo_gsc_data |
| Identity | whoami | — |
Errors reaching your assistant
MCP clients relay tool errors verbatim to the user, so the API's error contract is what they will read. The codes most likely to surface:
| Code | What the user should do |
|---|---|
UNAUTHENTICATED | Set a valid mseo_ key and reconnect the server. |
NOT_FOUND | The projectId is wrong or belongs to another organization — re-list projects. |
SEO_DATA_UNAVAILABLE | The metric has no honest source in this deployment's data mode. Not a bug. |
PLAN_LIMIT_REACHED | A plan quota is exhausted. Waiting will not clear it. |
RATE_LIMITED | Too many calls in the window. Retry after the stated delay. |
See Errors for the full table.