Argosor — Unified SEO, SERP, Clean Markdown & GEO (AI Citation Visibility) MCP Server

Execute a real-time Search Engine Results Page (SERP) query across Google, Bing, DuckDuckGo, Google News, or Google AI Overviews. Use this tool to inspect live organic rankings, People Also Ask questions, and generative AI Overview source citations for any target keyword. Returns ranked organic listings, AI Overview synthesis with cited URLs, SERP feature flags, and traffic estimates in Managed Edge or BYOK mode.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Search query or keyword phrase to inspect in real time (e.g., \"best seo api for ai agents\")."
    },
    "engine": {
      "type": "string",
      "enum": [
        "google",
        "bing",
        "duckduckgo",
        "google_news",
        "google_ai_overview"
      ],
      "default": "google",
      "description": "Target search engine vertical to query (default: \"google\")."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "default": "us",
      "description": "Two-letter ISO 3166-1 alpha-2 country code for localized geo-targeting such as \"us\", \"gb\", \"de\", or \"es\" (default: \"us\")."
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 5,
      "default": "en",
      "description": "Two-letter ISO 639-1 language code for SERP localization such as \"en\", \"es\", or \"fr\" (default: \"en\")."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 10,
      "description": "Maximum number of organic SERP results to return between 1 and 30 (default: 10)."
    },
    "include_ai_overview": {
      "type": "boolean",
      "default": true,
      "description": "When true, extracts the Google AI Overview generative summary and cited source URLs (default: true)."
    },
    "include_people_also_ask": {
      "type": "boolean",
      "default": true,
      "description": "When true, extracts People Also Ask (PAA) questions and answer snippets (default: true)."
    },
    "execution_mode": {
      "type": "string",
      "enum": [
        "managed",
        "byok"
      ],
      "default": "managed",
      "description": "Execution mode: \"managed\" ($0.0005 per query via Argosor Global Edge) or \"byok\" ($0 markup using encrypted vault credentials)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Run a read-only multi-LLM citation Share-of-Voice (SoV) and rank tracking audit across ChatGPT Search, Perplexity, Claude, Google AI Overviews, Gemini, and Grok (distinct from 'geo_content_write', which authors new Answer-First Markdown articles and '/vs/' tables). Use this tool to benchmark how often AI answer engines cite your 'domain' versus 'competitor_domains' for a 'prompt_topic' without generating or modifying content. Returns per-engine citation status, rank position, overall Share-of-Voice percentage, and competitor displacement metrics.

{
  "type": "object",
  "properties": {
    "brand_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Target brand or product name to audit across generative engines (e.g., \"Argosor\")."
    },
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Primary canonical root domain of the brand being audited (e.g., \"argosor.com\")."
    },
    "prompt_topic": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "default": "best seo and geo api for ai agents",
      "description": "High-intent buyer prompt or category topic used to evaluate Share-of-Voice across AI answer engines."
    },
    "competitors": {
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "description": "Competitor root domain name (e.g., \"dataforseo.com\", \"serpapi.com\")."
      },
      "description": "Optional list of up to 5 competitor domains to benchmark citation displacement against."
    },
    "llm_engines": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "enum": [
          "chatgpt_search",
          "perplexity",
          "claude",
          "google_ai_overviews",
          "google_ai_mode",
          "gemini",
          "grok",
          "deepseek",
          "copilot",
          "meta_ai"
        ],
        "description": "Identifier of the generative AI search engine to audit."
      },
      "description": "Optional subset of generative AI engines to include in the Share-of-Voice audit."
    },
    "force_refresh": {
      "type": "boolean",
      "default": false,
      "description": "When true, bypasses the 6-hour response deduplication cache and forces a fresh multi-engine audit (default: false)."
    }
  },
  "required": [
    "brand_name",
    "domain"
  ],
  "additionalProperties": false
}

Perform a live single-URL on-page HTML DOM and HTTP response header crawl to diagnose technical SEO and page-level indexability issues (distinct from 'agent_crawler_traffic_attribution', which analyzes domain-wide bot log telemetry and analytics regex). Use this tool to inspect a specific page 'url' for broken heading hierarchies, missing canonical or meta tags, embedded Schema.org JSON-LD validity, and '/llms.txt' presence. Returns HTTP status, TTFB latency, title and meta tags, H1-H3 DOM structure, Schema.org validation, and a prioritized technical health score.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 4,
      "maxLength": 2048,
      "description": "Full HTTP/HTTPS URL or domain to crawl and audit in real time (e.g., \"https://argosor.com\")."
    },
    "check_ai_crawlers": {
      "type": "boolean",
      "default": true,
      "description": "When true, fetches /robots.txt on the target origin to verify whether GPTBot, ClaudeBot, and PerplexityBot are permitted (default: true)."
    },
    "check_llms_txt": {
      "type": "boolean",
      "default": true,
      "description": "When true, probes /llms.txt on the target origin for machine-readable agent documentation (default: true)."
    },
    "check_schema_org": {
      "type": "boolean",
      "default": true,
      "description": "When true, parses and validates embedded application/ld+json Schema.org blocks on the page (default: true)."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Expand a seed keyword or product category into semantic topic clusters with monthly search volume, CPC benchmarks, and Keyword Difficulty scores. Use this tool when planning topical authority hubs, evaluating commercial and transactional search intent, or discovering conversational prompts that trigger AI answer engines. Returns structured pillar-and-spoke keyword clusters, buyer funnel classifications, conversational LLM prompt variants, and recommended URL slugs.

{
  "type": "object",
  "properties": {
    "seed_topic": {
      "type": "string",
      "minLength": 2,
      "maxLength": 160,
      "description": "Core seed keyword, product category, or topic to expand into semantic intent clusters (e.g., \"generative engine optimization api\")."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "default": "us",
      "description": "Two-letter ISO 3166-1 alpha-2 country code for search volume and CPC calibration (default: \"us\")."
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 5,
      "default": "en",
      "description": "Two-letter ISO 639-1 language code for keyword generation and intent classification (default: \"en\")."
    },
    "max_clusters": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 4,
      "description": "Maximum number of semantic topic clusters to generate between 1 and 10 (default: 4)."
    }
  },
  "required": [
    "seed_topic"
  ],
  "additionalProperties": false
}

Inspect a domain backlink authority profile and generative AI citation graph across referring domains and authoritative web sources. Use this tool to evaluate Domain Rating, link velocity, anchor text diversity, and which URLs on a domain are most frequently cited by LLMs. Returns Domain Rating (0-100), referring domain counts, dofollow/nofollow ratios, spam risk score, anchor text distribution, and top AI-cited pages.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Target root domain or hostname to analyze (e.g., \"argosor.com\")."
    },
    "include_anchor_distribution": {
      "type": "boolean",
      "default": true,
      "description": "When true, includes the categorized anchor text percentage breakdown (default: true)."
    },
    "include_llm_cited_pages": {
      "type": "boolean",
      "default": true,
      "description": "When true, includes the top URLs on the domain most frequently cited by Perplexity, ChatGPT Search, and Claude (default: true)."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Fetch any live web URL and convert its main content into clean, boilerplate-free Markdown optimized for RAG pipelines and autonomous agents. Use this tool when ingesting competitor pages, documentation, or articles without HTML noise, navigation chrome, or script tags. Returns structured Markdown preserving heading hierarchy and tables, extracted internal and external links, word and token counts, and a SHA-256 content digest.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "description": "Full HTTP or HTTPS web page URL to fetch and convert into clean Markdown."
    },
    "include_links": {
      "type": "boolean",
      "default": true,
      "description": "When true, extracts a structured list of outbound and internal anchor links from the page (default: true)."
    },
    "include_metadata": {
      "type": "boolean",
      "default": true,
      "description": "When true, includes page title, word count, estimated LLM token count, and SHA-256 content digest (default: true)."
    },
    "max_characters": {
      "type": "integer",
      "minimum": 500,
      "maximum": 100000,
      "default": 16000,
      "description": "Maximum character length of the returned Markdown document between 500 and 100000 (default: 16000)."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Build a multi-domain SEO and GEO competitive gap matrix comparing a primary domain against up to 5 competitors. Use this tool to uncover high-volume, low-difficulty keyword gaps, AI Share-of-Voice disparities, and high-converting comparison pages to publish next. Returns domain-by-domain authority metrics, missing keyword opportunities, citation gap scores, and ready-to-publish "/vs/*" page blueprints.

{
  "type": "object",
  "properties": {
    "primary_domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Primary root domain to benchmark against competitors (e.g., \"argosor.com\")."
    },
    "competitor_domains": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "description": "Competitor root domain (e.g., \"dataforseo.com\", \"serpapi.com\", \"ahrefs.com\", \"firecrawl.dev\")."
      },
      "description": "List of 1 to 5 competitor root domains to compare against the primary domain."
    },
    "focus_vertical": {
      "type": "string",
      "minLength": 2,
      "maxLength": 140,
      "default": "B2B SaaS & AI Developer Tools",
      "description": "Market vertical or product category description used to prioritize commercial keyword gaps (default: \"B2B SaaS & AI Developer Tools\")."
    }
  },
  "required": [
    "primary_domain",
    "competitor_domains"
  ],
  "additionalProperties": false
}

Generate a validated, deterministic Schema.org JSON-LD @graph payload for SoftwareApplication, Organization, FAQPage, Article, Product, or WebSite entities. Use this tool to create copy-pasteable structured data that maximizes Google Rich Results eligibility and improves entity disambiguation inside LLM knowledge graphs. Returns a validated JSON-LD object, an HTML script tag snippet ready for <head> injection, and entity graph completeness metrics.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "SoftwareApplication",
        "Organization",
        "FAQPage",
        "Article",
        "Product",
        "WebSite"
      ],
      "description": "Primary Schema.org entity type to generate in the @graph payload."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 140,
      "description": "Canonical brand, software product, organization, or article title (e.g., \"Argosor\")."
    },
    "url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "description": "Canonical HTTP/HTTPS URL for the entity (e.g., \"https://argosor.com\")."
    },
    "description": {
      "type": "string",
      "minLength": 10,
      "maxLength": 500,
      "description": "Concise factual summary of the entity optimized for search snippets and LLM citations."
    },
    "pricing_offers": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "price_usd"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Plan or offer tier name (e.g., \"Starter Plan\")."
          },
          "price_usd": {
            "type": "number",
            "minimum": 0,
            "description": "Monthly or unit price in USD (e.g., 19)."
          }
        }
      },
      "description": "Optional list of pricing tiers to embed as Schema.org Offer nodes."
    },
    "faq_items": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "question",
          "answer"
        ],
        "properties": {
          "question": {
            "type": "string",
            "description": "Frequently asked question text."
          },
          "answer": {
            "type": "string",
            "description": "Authoritative, concise answer text."
          }
        }
      },
      "description": "Optional FAQ question-and-answer pairs to embed as a linked Schema.org FAQPage node."
    }
  },
  "required": [
    "entity_type",
    "name",
    "url",
    "description"
  ],
  "additionalProperties": false
}

Provision a new Argosor workspace, developer account, and scoped API key in a single zero-browser call. Use this tool when an autonomous agent or developer wants to register a persistent workspace and receive $2.50 in free sandbox credits. Returns the newly minted Bearer API key, workspace metadata, magic console claim URL, and ready-to-paste MCP client configuration.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "minLength": 5,
      "maxLength": 254,
      "description": "Optional developer or agent owner email address; if omitted, provisions an instant claimable sandbox identity."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "default": "Autonomous MCP Agent",
      "description": "Display name for the developer or autonomous agent (default: \"Autonomous MCP Agent\")."
    },
    "workspace_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "default": "Argosor Growth & GEO Workspace",
      "description": "Human-readable workspace name (default: \"Argosor Growth & GEO Workspace\")."
    }
  },
  "additionalProperties": false
}

Inspect the active Argosor workspace subscription tier, remaining monthly query quota, USD credit ledger balance, and configured BYOK credentials. Use this tool before running large batch audits to verify available quota, active API keys, or encrypted provider connections. Returns workspace plan details, real-time usage counters, masked API key metadata, and BYOK vault status.

{
  "type": "object",
  "properties": {
    "include_api_keys": {
      "type": "boolean",
      "default": true,
      "description": "When true, lists active API keys and prefixes belonging to the workspace (default: true)."
    },
    "include_byok_vault": {
      "type": "boolean",
      "default": true,
      "description": "When true, lists encrypted BYOK provider credentials configured in the workspace vault (default: true)."
    }
  },
  "additionalProperties": false
}

Create a real-time Stripe Checkout session to upgrade an Argosor workspace subscription to Starter ($19/month), Builder ($39/month), or Scale ($79/month). Use this tool when a user or autonomous agent requests a plan upgrade, higher monthly query quotas, or a live payment link. Returns the live Stripe Checkout session URL, session identifier, selected plan specifications, and included monthly quota details.

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "enum": [
        "starter",
        "builder",
        "scale"
      ],
      "description": "Target Argosor subscription plan tier: \"starter\" ($19/month), \"builder\" ($39/month), or \"scale\" ($79/month)."
    },
    "customer_email": {
      "type": "string",
      "minLength": 5,
      "maxLength": 254,
      "description": "Optional billing email address used to prefill the Stripe Checkout session."
    },
    "success_url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "default": "https://argosor.com/app?billing=success",
      "description": "HTTPS redirect URL after a completed Stripe Checkout payment (default: \"https://argosor.com/app?billing=success\")."
    },
    "cancel_url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "default": "https://argosor.com/app?billing=cancel",
      "description": "HTTPS redirect URL if the user cancels Stripe Checkout (default: \"https://argosor.com/app?billing=cancel\")."
    }
  },
  "required": [
    "plan"
  ],
  "additionalProperties": false
}

Query real-time web, REST API, and MCP JSON-RPC traffic attribution telemetry across acquisition channels, AI agent harnesses, MCP tools, and countries. Use this tool with Allometrik administrator credentials to inspect live funnel conversions, tool invocation volume, and agent harness breakdown. Returns aggregated traffic counters, channel attribution tables, per-tool call distribution, and recent telemetry events.

{
  "type": "object",
  "properties": {
    "window_hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720,
      "default": 24,
      "description": "Lookback time window in hours between 1 and 720 (default: 24)."
    },
    "limit": {
      "type": "integer",
      "minimum": 5,
      "maximum": 100,
      "default": 25,
      "description": "Maximum number of recent live telemetry events to include between 5 and 100 (default: 25)."
    }
  },
  "additionalProperties": false
}

Generate citation-ready Answer-First GEO articles, HTML '/vs/' competitor comparison tables, FAQPage JSON-LD blocks, and '/llms.txt' markdown artifacts tailored to capture LLM citations (pure read-only content generation with zero external side effects, distinct from 'geo_llm_visibility_audit' which tracks live citation Share-of-Voice). Pass 'target_query' to define the buyer prompt, 'competitor_domains' to populate the HTML comparison matrix against your 'domain', and 'content_format' to select a full optimization pack or a specific artifact. Returns '{ answerFirstMarkdown, vsComparisonTableHtml, faqJsonLd, llmsTxtArtifact, reputationDimensions }' ready to stage or publish.

{
  "type": "object",
  "properties": {
    "brand_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Brand or product name to author Answer-First GEO content for (e.g., \"Argosor\")."
    },
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Primary canonical root domain of the brand (e.g., \"argosor.com\")."
    },
    "target_query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "Target buyer query or search prompt that the generated Answer-First article and FAQPage schema will directly answer (e.g., \"best enterprise seo and geo mcp server\")."
    },
    "competitor_domains": {
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "string",
        "description": "Competitor root domain (e.g., \"llmpulse.ai\", \"dataforseo.com\")."
      },
      "description": "Optional list of up to 4 competitor domains compared side-by-side against your domain in the generated \"/vs/\" HTML comparison table."
    },
    "content_format": {
      "type": "string",
      "enum": [
        "full_geo_pack",
        "answer_first_article",
        "vs_comparison_table",
        "llms_txt_artifact"
      ],
      "default": "full_geo_pack",
      "description": "Output artifact selection controlling whether to generate the complete GEO optimization pack, standalone Answer-First Markdown article, HTML \"/vs/\" comparison table, or \"/llms.txt\" manifest (default: \"full_geo_pack\")."
    },
    "target_url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "description": "Optional canonical page URL being drafted or rewritten; defaults to the root domain HTTPS homepage when omitted."
    }
  },
  "required": [
    "brand_name",
    "domain",
    "target_query"
  ],
  "additionalProperties": false
}

Analyze domain-level server log bot-hit telemetry, edge WAF bot-spoofing behavior, and AI referral attribution across Model Training Crawlers, AI Search Indexers, and User-Triggered Agent Browsers (distinct from 'technical_seo_crawl', which inspects single-page HTML DOM and HTTP headers). Use this tool to detect Cloudflare or AWS WAF rules blocking legitimate AI search bots on 'domain' and to generate referral attribution regex filters for your 'analytics_platform'. Returns 3-tier bot telemetry classifications, edge WAF spoofing diagnostics, and ready-to-paste GA4, Plausible, PostHog, and Nginx regex rules.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Target root domain to audit AI bot log telemetry, WAF spoofing, and referral attribution rules for (e.g., \"argosor.com\")."
    },
    "analytics_platform": {
      "type": "string",
      "enum": [
        "all",
        "ga4",
        "plausible",
        "posthog"
      ],
      "default": "all",
      "description": "Target analytics platform for generated referral attribution regex snippets (default: \"all\")."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Synchronize Google Search Console rank decay alerts (`action: 'sync_gsc_decay'`, read-only), stage Answer-First CMS rewrites (`action: 'stage_cms_rewrite'`, requires `target_url` and `target_keyword`, non-destructive draft), publish approved changes live (`action: 'publish_staged_change'`, requires `change_id` and `cms_platform`, mutates live CMS unless `night_routine=true` holds it in review), or revert a deployment (`action: 'rollback_change'`, requires `change_id`). Requires a valid Argosor Bearer API key and a connected BYOK CMS or GSC credential in the workspace vault. Returns `{ alerts, stagedDiff, changeId, actionBoard, rollbackReady }` sorted by expected click gain.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "sync_gsc_decay",
        "stage_cms_rewrite",
        "publish_staged_change",
        "rollback_change"
      ],
      "description": "Autopilot operation to execute: \"sync_gsc_decay\" (read-only GSC decay check), \"stage_cms_rewrite\" (non-destructive draft requiring target_url and target_keyword), \"publish_staged_change\" (mutates live CMS requiring change_id and cms_platform), or \"rollback_change\" (reverts a deployment requiring change_id)."
    },
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Target project root domain managed by the SEO and GEO Autopilot (e.g., \"argosor.com\")."
    },
    "cms_platform": {
      "type": "string",
      "enum": [
        "wordpress",
        "github_pr_nextjs_astro",
        "webflow",
        "ghost",
        "shopify",
        "custom_webhook"
      ],
      "default": "github_pr_nextjs_astro",
      "description": "Target CMS or Git deployment adapter used when action is \"stage_cms_rewrite\", \"publish_staged_change\", or \"rollback_change\" (default: \"github_pr_nextjs_astro\")."
    },
    "target_url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048,
      "description": "Target page URL to stage an Answer-First SEO and GEO rewrite for; required when action is \"stage_cms_rewrite\"."
    },
    "target_keyword": {
      "type": "string",
      "minLength": 2,
      "maxLength": 160,
      "description": "Primary keyword or buyer prompt targeted by the staged page rewrite; required when action is \"stage_cms_rewrite\" and optional filter for \"sync_gsc_decay\"."
    },
    "change_id": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "description": "Staged change identifier returned by a prior \"stage_cms_rewrite\" call; required when action is \"publish_staged_change\" or \"rollback_change\"."
    },
    "night_routine": {
      "type": "boolean",
      "default": true,
      "description": "Human-in-the-loop safety guardrail used by \"stage_cms_rewrite\" and \"publish_staged_change\": when true, holds changes in review status without mutating the live CMS (default: true)."
    }
  },
  "required": [
    "action",
    "domain"
  ],
  "additionalProperties": false
}