{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-03-26/mcp-discovery.schema.json","name":"argosor","title":"Argosor — Unified SEO, SERP, Clean Markdown & GEO (LLM Citation Visibility) MCP Server","version":"1.0.0","protocolVersion":"2025-03-26","description":"15-tool semantic MCP server and REST API for live Google/Bing SERP intelligence, Generative Engine Optimization (GEO) Share-of-Voice audits across ChatGPT Search, Perplexity, Claude, Google AI Overviews, Gemini, and Grok, technical SEO & AI-readiness crawling, keyword intent clustering, backlink authority graphs, clean Markdown RAG extraction, competitor gap matrices, and deterministic Schema.org JSON-LD generation.","homepage":"https://argosor.com","documentationUrl":"https://mcp.argosor.com/docs","consoleUrl":"https://mcp.argosor.com/app","openApiUrl":"https://mcp.argosor.com/openapi.json","llmsTxtUrl":"https://mcp.argosor.com/llms.txt","transport":{"type":"streamable-http","endpoint":"https://mcp.argosor.com/mcp","authentication":{"type":"bearer","headerName":"Authorization","scheme":"Bearer","prefix":"arg_live_","requiredForDiscovery":false,"zeroDropoffTrialProvisioning":true,"registrationEndpoint":"https://mcp.argosor.com/v1/auth/register"}},"capabilities":{"tools":true,"prompts":true,"resources":true},"tdqs":{"score":100,"grade":"A","toolCount":15,"promptsCount":4,"resourcesCount":3},"tools":[{"name":"serp_live_search","description":"Execute a real-time Search Engine Results Page (SERP) query across Google, Bing, DuckDuckGo, Google News, or Google AI Overviews. Returns ranked organic listings, AI Overview synthesis and cited URLs, People Also Ask (PAA) questions, and traffic estimates. Supports Managed Edge execution ($0.0005/query, 70% cheaper than legacy SERP APIs) or BYOK ($0 markup).","annotations":{"title":"Live Multi-Engine SERP & AI Overview Search","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","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"],"description":"Target search engine vertical to query. Defaults to \"google\"."},"country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code for localized geo-targeting (e.g., \"us\", \"gb\", \"de\", \"es\"). Defaults to \"us\"."},"language":{"type":"string","description":"Two-letter ISO 639-1 language code for SERP localization (e.g., \"en\", \"es\", \"fr\"). Defaults to \"en\"."},"limit":{"type":"integer","minimum":1,"maximum":30,"description":"Maximum number of organic SERP results to return (1 to 30). Defaults to 10."},"includeAiOverview":{"type":"boolean","description":"When true, extracts Google AI Overview / generative summary and cited source URLs. Defaults to true."},"includePeopleAlsoAsk":{"type":"boolean","description":"When true, extracts People Also Ask (PAA) questions and answer snippets. Defaults to true."},"executionMode":{"type":"string","enum":["managed","byok"],"description":"Execution mode: \"managed\" ($0.0005/query via Argosor Global Edge) or \"byok\" ($0 markup using encrypted vault credentials). Defaults to \"managed\"."}}}},{"name":"geo_llm_visibility_audit","description":"Run a Generative Engine Optimization (GEO) and LLM Citation Share-of-Voice (SoV) audit across ChatGPT Search, Perplexity, Claude, Google AI Overviews, Gemini, and Grok. Probes live domain signals (/llms.txt, Schema.org JSON-LD) and returns brand mention rate, citation rank, competitor displacement, and concrete recommendations to capture more AI citations.","annotations":{"title":"GEO & Multi-LLM Citation Visibility Audit","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["brandName","domain"],"properties":{"brandName":{"type":"string","description":"Target brand or product name to audit across generative engines (e.g., \"Argosor\")."},"domain":{"type":"string","description":"Primary canonical domain of the brand being audited (e.g., \"argosor.com\")."},"promptTopic":{"type":"string","description":"High-intent buyer prompt or category topic to evaluate Share-of-Voice for (e.g., \"best seo and geo api for ai agents\")."},"competitors":{"type":"array","items":{"type":"string","description":"Competitor domain name (e.g., \"dataforseo.com\", \"serpapi.com\")."},"description":"Optional list of competitor domains to benchmark citation displacement against."},"llmEngines":{"type":"array","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 the 9 generative AI engines to include in the Share-of-Voice audit."},"forceRefresh":{"type":"boolean","description":"When true, bypasses the 6-hour response deduplication cache and forces a fresh multi-engine audit. Defaults to false."}}}},{"name":"technical_seo_crawl","description":"Perform a live HTTP + HTML technical SEO and AI-crawler readiness audit on any URL. Inspects HTTP status, response latency, title, meta description, canonical tag, H1-H3 heading hierarchy, Schema.org JSON-LD blocks, robots.txt permissions for AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended), and /llms.txt availability.","annotations":{"title":"Live Technical SEO & AI Crawler Readiness Audit","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","description":"Full URL or domain to crawl and audit (e.g., \"https://argosor.com\")."},"checkAiCrawlers":{"type":"boolean","description":"When true, fetches /robots.txt on the target origin to verify whether GPTBot, ClaudeBot, and PerplexityBot are permitted. Defaults to true."},"checkLlmsTxt":{"type":"boolean","description":"When true, probes /llms.txt on the target origin for machine-readable agent documentation. Defaults to true."},"checkSchemaOrg":{"type":"boolean","description":"When true, parses and counts embedded application/ld+json Schema.org blocks. Defaults to true."}}}},{"name":"keyword_intent_cluster","description":"Generate semantic keyword clusters with monthly search volume, CPC (USD), Keyword Difficulty (KD 0-100), buyer intent classification (commercial, transactional, informational, navigational), and recommended pillar-and-spoke URL slugs for both organic search and LLM citation capture.","annotations":{"title":"Semantic Keyword Intent & Pillar Clustering","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["seedTopic"],"properties":{"seedTopic":{"type":"string","description":"Core seed keyword or product category to expand into semantic intent clusters (e.g., \"generative engine optimization api\")."},"country":{"type":"string","description":"Two-letter ISO country code for search volume and CPC calibration (e.g., \"us\", \"gb\"). Defaults to \"us\"."},"language":{"type":"string","description":"Two-letter ISO language code for keyword generation (e.g., \"en\"). Defaults to \"en\"."},"maxClusters":{"type":"integer","minimum":1,"maximum":10,"description":"Maximum number of semantic topic clusters to generate (1 to 10). Defaults to 4."}}}},{"name":"backlink_authority_graph","description":"Inspect a domain’s backlink authority profile and LLM citation graph. Returns Domain Rating (DR 0-100), referring domains count, total backlinks, dofollow/nofollow ratio, spam risk score, anchor text distribution, and top pages most frequently cited by AI search engines.","annotations":{"title":"Backlink Authority & LLM Citation Graph","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","description":"Target root domain or hostname to analyze (e.g., \"argosor.com\")."},"includeAnchorDistribution":{"type":"boolean","description":"When true, includes categorized anchor text percentage breakdown. Defaults to true."},"includeLlmCitedPages":{"type":"boolean","description":"When true, includes the top URLs on the domain most frequently cited by Perplexity, ChatGPT Search, and Claude. Defaults to true."}}}},{"name":"markdown_clean_extract","description":"Fetch any live web URL and convert it into clean, boilerplate-free, LLM-ready Markdown for RAG pipelines and autonomous research agents. Strips scripts, styles, ads, and navigation chrome while preserving heading hierarchy, lists, canonical links, token count, and SHA-256 content hash at 90% lower cost than legacy scrapers.","annotations":{"title":"Live Web URL to Clean LLM Markdown Extractor","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","description":"Full HTTP/HTTPS web page URL to fetch and convert into clean Markdown."},"includeLinks":{"type":"boolean","description":"When true, extracts a structured list of outbound and internal anchor links from the page. Defaults to true."},"includeMetadata":{"type":"boolean","description":"When true, includes title, word count, estimated LLM token count, and SHA-256 content digest. Defaults to true."},"maxCharacters":{"type":"integer","minimum":500,"maximum":100000,"description":"Maximum character length of the returned Markdown document (500 to 100,000). Defaults to 16000."}}}},{"name":"competitor_gap_matrix","description":"Build a multi-domain SEO and GEO competitive gap matrix comparing a primary domain against up to 5 competitors. Identifies high-volume, low-difficulty keyword gaps, AI Share-of-Voice disparities, unit cost benchmarks, and the highest-ROI comparison pages (/vs/*) to publish next.","annotations":{"title":"Multi-Domain SEO & GEO Competitor Gap Matrix","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["primaryDomain","competitorDomains"],"properties":{"primaryDomain":{"type":"string","description":"Your primary domain to benchmark (e.g., \"argosor.com\")."},"competitorDomains":{"type":"array","items":{"type":"string","description":"Competitor root domain (e.g., \"dataforseo.com\", \"serpapi.com\", \"ahrefs.com\", \"firecrawl.dev\")."},"description":"Array of 1 to 5 competitor domains to compare against the primary domain."},"focusVertical":{"type":"string","description":"Optional market vertical or product category description for tailored gap prioritization."}}}},{"name":"schema_jsonld_generator","description":"Generate a validated, deterministic Schema.org JSON-LD @graph payload (SoftwareApplication, Organization, FAQPage, Article, Product, WebSite) ready to embed in HTML <head>. Maximizes eligibility for Google Rich Results and improves entity disambiguation inside LLM knowledge graphs.","annotations":{"title":"Deterministic Schema.org JSON-LD Graph Generator","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["entityType","name","url","description"],"properties":{"entityType":{"type":"string","enum":["SoftwareApplication","Organization","FAQPage","Article","Product","WebSite"],"description":"Primary Schema.org entity type to generate."},"name":{"type":"string","description":"Canonical brand, product, or article title (e.g., \"Argosor\")."},"url":{"type":"string","description":"Canonical URL for the entity (e.g., \"https://argosor.com\")."},"description":{"type":"string","description":"Concise factual summary of the entity optimized for search snippets and LLM citations."},"pricingOffers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","priceUsd"],"properties":{"name":{"type":"string","description":"Plan or offer tier name (e.g., \"Starter Plan\")."},"priceUsd":{"type":"number","description":"Monthly or unit price in USD (e.g., 19)."}}},"description":"Optional array of pricing tiers to embed as Schema.org Offer nodes."},"faqItems":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["question","answer"],"properties":{"question":{"type":"string","description":"Frequently asked question text."},"answer":{"type":"string","description":"Authoritative answer text."}}},"description":"Optional FAQ items to embed as a linked Schema.org FAQPage node."}}}},{"name":"account_register","description":"Zero-browser autonomous workspace registration. Creates a new Argosor account, relational workspace, and scoped API key (arg_live_...) in a single call, returning a magic console claim URL and $2.50 in free sandbox credits.","annotations":{"title":"Zero-Browser Agent Workspace Registration","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","description":"Optional developer or agent owner email address. If omitted, provisions an instant claimable sandbox identity."},"name":{"type":"string","description":"Optional display name for the developer or autonomous agent."},"workspaceName":{"type":"string","description":"Optional workspace name (e.g., \"Acme Growth & GEO Agent\")."}}}},{"name":"account_status","description":"Inspect the active Argosor workspace, plan tier (free, starter, builder, scale), remaining monthly query quota, USD credit ledger balance, minted API keys, and connected AES-256-GCM BYOK credentials.","annotations":{"title":"Workspace Quota, BYOK Vault & Billing Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"includeApiKeys":{"type":"boolean","description":"When true, lists active API keys belonging to the workspace. Defaults to true."},"includeByokVault":{"type":"boolean","description":"When true, lists encrypted BYOK provider credentials (DataForSEO, SerpApi, Ahrefs, Firecrawl, OpenAI, Perplexity) configured in the workspace vault. Defaults to true."}}}},{"name":"billing_upgrade","description":"Generate a Stripe Live Checkout session to upgrade the workspace plan (Starter $19/mo, Builder $39/mo, Scale $79/mo) or retrieve the Stripe Live catalog and Customer Billing Portal URL.","annotations":{"title":"Stripe Live Plan Upgrade & Checkout Session","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["plan"],"properties":{"plan":{"type":"string","enum":["starter","builder","scale"],"description":"Target Argosor subscription plan tier: \"starter\" ($19/mo), \"builder\" ($39/mo), or \"scale\" ($79/mo)."},"successUrl":{"type":"string","description":"Optional redirect URL after completed Stripe Checkout payment."},"cancelUrl":{"type":"string","description":"Optional redirect URL if checkout is canceled."}}}},{"name":"traffic_analytics","description":"Query real-time web, REST API, and MCP JSON-RPC traffic attribution telemetry across acquisition channels, AI agent harnesses (Cursor, Claude, Grok, OpenClaw), MCP tools, and countries. Restricted to Allometrik master admin credentials.","annotations":{"title":"Admin Traffic & MCP Attribution Telemetry","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"windowHours":{"type":"integer","minimum":1,"maximum":720,"description":"Lookback time window in hours (1 to 720). Defaults to 24."},"limit":{"type":"integer","minimum":5,"maximum":100,"description":"Maximum number of recent live events to include (5 to 100). Defaults to 25."}}}},{"name":"geo_reputation_and_writer","description":"Run a 7-Dimension AI Brand Reputation & Narrative Audit (authority, trust & compliance, pricing value, technical depth, citation freshness, sentiment polarity, entity clarity) across live web, news, Hacker News, Wikipedia, and connected LLMs, and generate an Answer-First GEO Content & Markdown Twin Writer pack (Answer-First Markdown section, HTML comparison <table>, FAQPage JSON-LD, and Content-Signal robots.txt rule). Includes 6-hour response caching.","annotations":{"title":"7D AI Brand Reputation Audit & Answer-First GEO Writer","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["brandName","domain","targetPrompt"],"properties":{"brandName":{"type":"string","description":"Brand or product name to evaluate and write Answer-First GEO content for (e.g., \"Argosor\")."},"domain":{"type":"string","description":"Primary canonical domain of the brand (e.g., \"argosor.com\")."},"targetPrompt":{"type":"string","description":"High-intent buyer prompt or topic to optimize citation capture for (e.g., \"best enterprise seo and geo mcp server\")."},"targetUrl":{"type":"string","description":"Optional specific page URL being optimized (defaults to https://<domain>)."},"competitors":{"type":"array","items":{"type":"string","description":"Competitor root domain (e.g., \"llmpulse.ai\", \"dataforseo.com\")."},"description":"Optional list of up to 4 competitor domains for the generated Answer-First comparison table."},"forceRefresh":{"type":"boolean","description":"When true, bypasses the 6-hour response deduplication cache. Defaults to false."}}}},{"name":"agent_crawler_traffic_attribution","description":"Audit a domain’s 3-tier AI crawler readiness—separating Training Crawlers (GPTBot, CCBot, Google-Extended), AI Search Indexers (OAI-SearchBot, PerplexityBot, Applebot-Extended), and Live User-Triggered Agent Browsers (ChatGPT-User, Claude-Web, Perplexity-User)—verify edge WAF bot-spoofing behavior, and generate ready-to-paste GA4, Plausible, PostHog, and Nginx AI traffic attribution regex filters covering 15+ AI answer engines.","annotations":{"title":"3-Tier AI Crawler Readiness & GA4/Plausible/PostHog Attribution","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","description":"Target root domain to audit AI crawler taxonomy and generate analytics attribution filters for (e.g., \"argosor.com\")."},"analyticsPlatform":{"type":"string","enum":["all","ga4","plausible","posthog"],"description":"Target analytics platform for attribution snippets. Defaults to \"all\"."}}}},{"name":"cms_autopilot_and_gsc_sync","description":"Closed-loop SEO & GEO Autopilot, Google Search Console (GSC) rank decay heartbeat, Multi-CMS staging (WordPress, GitHub PR for Next.js/Astro, Webflow, Ghost, Shopify, custom webhook), and Shared Action Board orchestrator (actions grouped by type and sorted by expected_clicks descending, assigned to Chief of SEO, Analyst, Writer, or Refresher, where night routines always stop at \"Ready for review\" for human approval).","annotations":{"title":"Multi-CMS SEO/GEO Autopilot, GSC Heartbeat & Shared Action Board","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","additionalProperties":false,"required":["action","domain"],"properties":{"action":{"type":"string","enum":["save_project_context","track_keywords_rank","gsc_performance_sync","stage_rewrite_for_approval","approve_and_publish","rollback_change","list_action_board","update_action_board_item"],"description":"Autopilot operation to execute: manage project memory, run weekly rank decay checks, stage/approve/rollback CMS rewrites, or list/update the Shared Action Board."},"domain":{"type":"string","description":"Target project domain (e.g., \"argosor.com\")."},"brandName":{"type":"string","description":"Optional brand display name for project memory and Answer-First rewrite staging."},"brandVoiceGuidelines":{"type":"string","description":"Optional brand voice and tone guidelines stored in persistent project memory."},"cmsPlatform":{"type":"string","enum":["wordpress","github_pr_nextjs_astro","webflow","ghost","shopify","custom_webhook"],"description":"Target CMS or Git deployment target for staged rewrites and 1-click rollbacks. Defaults to \"github_pr_nextjs_astro\"."},"keywords":{"type":"array","items":{"type":"string","description":"Target keyword phrase to track."},"description":"Optional list of target keywords to save or check for 3+ position decay."},"targetUrl":{"type":"string","description":"Target page URL when staging an Answer-First SEO/GEO rewrite for human approval."},"targetKeyword":{"type":"string","description":"Primary keyword when staging a page rewrite."},"changeId":{"type":"string","description":"Staged change ID when calling approve_and_publish or rollback_change."},"actionItemId":{"type":"string","description":"Action Board item ID when calling update_action_board_item."},"owner":{"type":"string","enum":["Chief of SEO","Analyst","Writer","Refresher"],"description":"Specialist agent owner on the Shared Action Board."},"status":{"type":"string","enum":["Todo","Working","Blocked","Ready for review","Done"],"description":"Workflow status on the Shared Action Board. Night routines automatically cap status at \"Ready for review\"."},"expectedClicks":{"type":"integer","minimum":0,"maximum":1000000,"description":"Estimated monthly organic + AI click gain used to sort the Shared Action Board descending."},"nightRoutine":{"type":"boolean","description":"When true, enforces the night routine guardrail so items stop at \"Ready for review\" (requires_human_approval: true)."}}}}],"prompts":[{"name":"full_geo_and_seo_domain_audit","description":"Comprehensive 4-step workflow to audit a domain’s technical SEO, LLM citation Share-of-Voice (GEO), backlink authority, and Schema.org JSON-LD graph.","arguments":[{"name":"domain","description":"Target root domain to audit (e.g., argosor.com)","required":true},{"name":"promptTopic","description":"Core buyer prompt topic to measure LLM citation visibility for","required":true}]},{"name":"competitor_displacement_blueprint","description":"Compare your domain against up to 5 competitors to uncover high-intent keyword gaps and generate /vs/* comparison pages that capture ChatGPT and Perplexity citations.","arguments":[{"name":"primaryDomain","description":"Your primary domain name","required":true},{"name":"competitorDomain","description":"Primary competitor domain name","required":true}]},{"name":"rag_clean_markdown_ingestion","description":"Extract clean, boilerplate-free Markdown and canonical links from a target documentation or research URL for LLM RAG context.","arguments":[{"name":"url","description":"Target web URL to extract clean Markdown from","required":true}]},{"name":"schema_org_entity_disambiguation","description":"Generate a validated Schema.org @graph (SoftwareApplication + Organization + FAQPage) for maximum Google AI Overviews and LLM citation accuracy.","arguments":[{"name":"brandName","description":"Brand or software application name","required":true},{"name":"url","description":"Canonical homepage URL","required":true}]}],"resources":[{"uri":"argosor://catalog/pricing-and-stripe-plans","name":"Argosor Pricing, Unit Economics & Stripe Live Plan Catalog","description":"Complete breakdown of Argosor Free, Starter ($19/mo), Builder ($39/mo), and Scale ($79/mo) tiers, plus BYOK ($0 markup) vs Managed (70% savings) unit economics.","mimeType":"application/json"},{"uri":"argosor://docs/geo-citation-playbook-2026","name":"2026 Generative Engine Optimization (GEO) Engineering Playbook","description":"Actionable checklist for ranking in ChatGPT Search, Perplexity, Claude, Google AI Overviews, Gemini, and Grok using /llms.txt, Schema.org @graph, and comparison tables.","mimeType":"text/markdown"},{"uri":"argosor://schemas/15-semantic-tools","name":"Argosor 15-Tool Semantic MCP Specification (TDQS 100/100)","description":"Machine-readable catalog of all 15 Argosor MCP tools, annotations, and input schemas.","mimeType":"application/json"}]}