Seonix

Mark an issue thread as an intentional choice (write scope — ask the user first): it stops counting against the score and stays marked across scans. Typical uses: noindex on pagination, a deliberately short page, a redirect that must stay. Undo with unacknowledge_issue.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "acknowledge_issue",
    "arguments": {
      "issue_id": "..."
    }
  }
}

Run Seonix's deterministic SEO + readability + AI-answer (AEO) scoring on ANY draft you pass (title + HTML + meta + keyphrase). No AI credits are spent. Use it as a linter: fix the problems it lists, re-run until the score is ≥ 80, then publish.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "analyze_seo",
    "arguments": {
      "title": "...",
      "html": "..."
    }
  }
}

Have Seonix apply fixes on the live site through the WordPress plugin (write scope — tell the user exactly which issue codes and get a yes first). Works for get_fix_plan items with fix_tier auto or ai_assist (wp_plugin_fixable); the site must have a connected WordPress channel. Starts a run (preview → Seonix suggestions → apply) and returns its id; poll get_fix_run until status is completed, partial or failed. Undo with rollback_fix.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "apply_fix",
    "arguments": {
      "issue_codes": "..."
    }
  }
}

The Seonix account behind this API key: email, every project with its plan, whether the MCP is available for it (paid plans only), AI/publish permissions and this month's article quota. Call this first.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_account",
    "arguments": {}
  }
}

The latest AI Visibility snapshot: how often the brand appears in ChatGPT answers for the project's prompts, which competitors are mentioned, top cited sources. Measurement covers ChatGPT only.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_ai_visibility",
    "arguments": {}
  }
}

One article with SEO title, meta description, excerpt, key takeaways, the stored SEO analysis, publications (where it is live) and optionally the full HTML.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_article",
    "arguments": {
      "article_id": "..."
    }
  }
}

The Seonix skill for connecting a custom-built site or blog as a publishing channel (endpoints, payload, read routes, media, self-test, hand-over). Same text as https://seonix.ai/SKILL.md. Pass section to get one step.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_blog_integration_guide",
    "arguments": {}
  }
}

Calendar slots for a month: planned / writing / completed / failed, kind create or optimize, source manual or autopilot, linked article ids.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_calendar",
    "arguments": {}
  }
}

One cluster with its member keywords, the site pages already covering it, the live SERP snapshot status and the competitor insights Seonix extracted (must-mention entities, recommended blocks, topical coverage, gaps).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "cluster_id": "..."
    }
  }
}

An ordered, implementable plan for every open problem: what to change, where (page / site-wide / theme), on which URLs, with the target example. Returned as structured items; pass include_markdown=true to also get a Markdown checklist in the `[HIGH] Title — Location / Issue / Fix` format. Pages with limit/offset. Items with wp_plugin_fixable / fix_tier auto or ai_assist can be applied by Seonix itself through apply_fix (WordPress). After applying fixes, call start_scan (with the user's yes) and get_site_health again to confirm what cleared.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_fix_plan",
    "arguments": {}
  }
}

Status and outcome of an apply_fix run: counts (applied / already correct / no-op / errors) and the per-item results with the before and after values.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_fix_run",
    "arguments": {
      "run_id": "..."
    }
  }
}

One issue with the evidence the scanner captured on the page (the offending tag, heading outline, redirect chain, JSON-LD block…) and the remediation profile: why it matters, bad vs good example, how-to-fix steps, whether Seonix can fix it through the WordPress plugin.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_issue",
    "arguments": {
      "issue_id": "..."
    }
  }
}

Plan and entitlements for one project: whether the MCP is available, AI generation and publishing permissions, article quota used/limit, and the upgrade link when the project is on Free.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_plan_status",
    "arguments": {}
  }
}

Read one Seonix playbook by name (same text as the prompt of that name) — for clients that do not surface MCP prompts.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_playbook",
    "arguments": {
      "name": "..."
    }
  }
}

One project: site URL, language, autopilot mode and cadence, Search Console connection, publishing channels, plan and quota, SEO progress level, dashboard links. Paid plans only.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_project",
    "arguments": {}
  }
}

The Seonix remediation profile for an issue code (no project needed): why it matters, bad/good example, fix steps, fix tier, warnings. Use when you meet an unfamiliar code.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_remediation_profile",
    "arguments": {
      "code": "..."
    }
  }
}

Proof-of-ranking ledger: for each published article, Search Console clicks / impressions / position now vs the previous period, with trend. Requires Search Console.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_results",
    "arguments": {}
  }
}

Progress of one scan: stage, pages found / scanned, counts, whether background probes are still pending. Poll every 5–10 seconds while status is not completed.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_scan_status",
    "arguments": {
      "scan_id": "..."
    }
  }
}

The project's SEO Progress ladder: current level and stage, what the next level requires (published articles, quality, Search Console, cluster coverage) and the publishing cadence Seonix recommends for this level.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_seo_progress",
    "arguments": {}
  }
}

The project's brand profile Seonix extracted and the owner refined: what the business does, audience, tone, language, writing instructions — plus the ready-to-use prompt block. Read it before writing or rewriting anything for the site.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_site_dna",
    "arguments": {}
  }
}

Site Health for a project: overall score, the four pillars (SEO, AI search, speed, technical), counts of active / fixed / came-back problems, the top open problems by priority, the last scan and the next scheduled check. Start here for any "what's wrong with my site" question.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_site_health",
    "arguments": {}
  }
}

Indexing coverage Seonix collected from Search Console: indexed / not indexed / unknown counts, sitemap status, and the pages that are not indexed with Google's verdict.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_coverage",
    "arguments": {}
  }
}

Seonix's own impact estimate: current vs potential traffic, keyword coverage, article impacts and top keyword opportunities.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_impact",
    "arguments": {}
  }
}

Keywords already ranking in a position band (default 4–20) with impressions, ordered by the traffic Seonix estimates they would bring at the target position. The classic striking-distance list: refresh those pages first.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_opportunities",
    "arguments": {}
  }
}

The queries one page ranks for (Search Console page+query report filtered to that URL). Use it before rewriting a page's title, meta description or headings.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_page_queries",
    "arguments": {
      "url": "..."
    }
  }
}

Whether Google Search Console is connected for the project, which property, and the last date with published data. Call before other gsc_* tools.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_status",
    "arguments": {}
  }
}

Daily clicks, impressions, average position and potential traffic for the last N days (7–90), plus the previous-period average position for comparison.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_timeseries",
    "arguments": {}
  }
}

Top landing pages from Search Console for the window: clicks, impressions, CTR, average position.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_top_pages",
    "arguments": {}
  }
}

Top search queries from Search Console for the window: clicks, impressions, CTR, average position.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "gsc_top_queries",
    "arguments": {}
  }
}

Articles in the project (Seonix-generated and imported): status, scores, keyphrase, cluster, publish dates. Paginated.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_articles",
    "arguments": {}
  }
}

Connected publishing channels (WordPress, Ghost, Webflow, Shopify, Wix, Custom API) with status. A project needs a connected channel before anything can be published.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_channels",
    "arguments": {}
  }
}

Topic clusters (one target page each) with primary keyword, intent, page type, priority, volume, Search Console impressions and winnability. The content plan is built from these.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {}
  }
}

Persistent issue threads (one per problem per page) with status open / solved / regressed, filterable by code, URL and status. Paginated. Each item carries the issue id for get_issue.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_issues",
    "arguments": {}
  }
}

Keywords Seonix researched for the project (seed AI, planner, Search Console, autocomplete, user-added) with volume, competition, Search Console numbers and cluster membership. Paginated; filter by status and substring.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_keyword_candidates",
    "arguments": {}
  }
}

The Seonix playbooks (step-by-step procedures that tell you which tools to call): promote a site, work through a page, fix issues in code, keyword map, internal links, write an article, striking distance, monthly report, connect a blog. Use get_playbook to read one.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_playbooks",
    "arguments": {}
  }
}

Projects (websites) in the account with id, slug, name and site URL. Use the id or slug as project_id in other tools.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_projects",
    "arguments": {}
  }
}

Recent site scans with status, pages scanned and severity counts.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_scans",
    "arguments": {}
  }
}

Reverse the changes an apply_fix run made on the live site, restoring the values the plugin snapshotted before applying (write scope — ask the user first).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "rollback_fix",
    "arguments": {
      "run_id": "..."
    }
  }
}

Re-run the SEO + readability scoring on an article already in Seonix (no changes saved) and list its problems.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "score_article",
    "arguments": {
      "article_id": "..."
    }
  }
}

Start a fresh Site Health scan of the project's site (write scope — ask the user first). Returns the scan id; poll get_scan_status every 10 seconds until status is completed, then call get_site_health / get_fix_plan to see what cleared. One scan at a time per project; the plan's page budget applies.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "start_scan",
    "arguments": {}
  }
}

Remove the intentional mark from an issue thread so it is scored and counted again (write scope).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "unacknowledge_issue",
    "arguments": {
      "issue_id": "..."
    }
  }
}