measure-organic-mcp 0.6.1

AI-powered Organic Growth Operations (SEO · ASO · GEO) over the Model Context Protocol.

🌱 Measure Organic MCP

AI-powered Organic Growth Operations — SEO · ASO · GEO — over the Model Context Protocol.

Audit · analyse · monitor your organic search presence in natural language, from Claude, ChatGPT, Codex, Gemini or any MCP client.

A product of the Measure AI ecosystem · built on measure-sdk.

---

What is Measure Organic MCP?

An open-source MCP server for organic growth: it analyses Search Console performance, audits indexation, technical SEO and Core Web Vitals, finds content opportunities and produces an Organic Health Score — read-only and safe.

"Audit my organic search performance for the last 30 days."
"Find pages with high impressions and low CTR."
"Which queries declined the most this month?"
"Inspect this URL and tell me if it has indexing issues."
"Validate my sitemap and robots.txt."
"Audit Core Web Vitals for my top organic pages."
"Generate an organic growth report."
"Prioritize SEO actions for this week."

Why SEO + ASO + GEO?

Organic visibility no longer lives only in classic search. SEO (Google Search), ASO (app stores) and GEO (Generative Engine Optimization — AI answers) are one growth surface — and this MCP covers all three: the full SEO core, real GEO (Perplexity + Gemini grounding) and ASO (App Store Connect

• Google Play) connectors, plus premium sources (Bing, Ahrefs, Semrush).

Relationship to Measure SDK

Like every Measure product, this depends on only measure-sdk:

Provided by measure-sdk	Provided by this repo
OAuth, sessions, credential storage	SEO connectors (Search Console, PageSpeed, sitemaps, robots, crawl)
Config, logging, HTTP, retry	Search performance / indexation / technical / CWV / content engines
MCP utilities, base CLI (measure login)	MCP server + organic tools + Organic Health Score
Shared domain models & enums	Normalised SEO models (QueryStat, UrlInspection, …)

Result types — AuditFinding, Recommendation, Report, HealthScore, Connection — come from the SDK and are never redefined here.

Install

pip install measure-organic-mcp     # pulls measure-sdk automatically
measure login                       # Google OAuth (Search Console)
measure-organic                     # start the MCP server (stdio)

Try it instantly (demo mode)

No Search Console access? Explore every tool with realistic sample data:

MEASURE_ORG_DEMO=true measure-organic

MCP tools (54)

Group	Tools
Discovery	list_connected_sites, get_site_overview, check_organic_health, generate_organic_health_score
Search Performance	get_search_performance, compare_search_performance, find_declining_queries, find_declining_pages, find_low_ctr_opportunities, find_position_opportunities
Indexation	inspect_url, audit_indexation, validate_sitemaps, check_robots_txt
Performance	analyze_pagespeed, audit_core_web_vitals
Technical SEO	audit_technical_seo, find_metadata_issues, find_canonical_issues, find_broken_links_from_crawl_export, detect_redirect_chains, find_orphan_pages
Content	find_content_opportunities, detect_cannibalization, suggest_content_updates, cluster_queries_by_intent, find_pages_to_refresh, generate_title_recommendations, suggest_internal_links
GEO	check_ai_visibility, test_prompts_across_models, monitor_brand_mentions, compare_ai_visibility_vs_competitors, analyze_ai_citations, generate_geo_recommendations, generate_ai_visibility_report
ASO	list_apps, audit_app_store_listing, audit_google_play_listing, analyze_reviews, detect_rating_issues, find_aso_opportunities, generate_aso_recommendations
Premium	get_bing_search_performance, get_backlinks, get_semrush_positions
Reporting	generate_organic_report, generate_executive_organic_summary, generate_technical_seo_report, generate_content_opportunity_report
Recommendations	generate_organic_recommendations, prioritize_organic_actions, create_organic_execution_plan
Alerts	run_organic_alert_now (evaluate an organic alert)

Organic Health Score

A standard 0-100 score (SDK HealthScore) weighting Search Performance 25%, Indexation 20%, Technical SEO 20%, Content 15%, Core Web Vitals 10%, Structured Data 5%, GEO Readiness 3%, ASO Readiness 2% — comparable across the ecosystem.

Supported sources

Phase	Sources
v0.1 (SEO Core)	Google Search Console ✅ · PageSpeed Insights ✅ · sitemap.xml ✅ · robots.txt ✅ · crawl exports (Screaming Frog / Sitebulb) ✅
v0.2-0.3	technical-SEO from crawls · content opportunity engine
v0.4 (GEO)	Perplexity ✅ · Gemini grounding ✅ · AI visibility
v0.5 (ASO)	App Store Connect ✅ · Google Play ✅
v0.6	Bing Webmaster ✅ · Ahrefs ✅ · Semrush ✅ · AppTweak · Sensor Tower 🛣️

Architecture (Clean Architecture)

src/measure_organic/
├── core/          # domain: SEO models, enums, connector port
├── config/        # settings (extends SDK CoreSettings; optional, non-secret)
├── connectors/    # infrastructure: search_console, pagespeed, sitemaps, robots,
│                  #   crawl_exports, perplexity, gemini, app_store_connect,
│                  #   google_play, bing_webmaster, ahrefs, semrush
├── engines/       # application: seo, indexation, technical, content, performance,
│                  #   geo, aso, recommendations, alerts, health_score
├── services/      # orchestration (connectors → engines)
├── validators/    # input validation → SDK ValidationResult
├── mcp/           # interface: server.py + tools/
└── cli/           # the measure-organic entry point

See docs/architecture/overview.md.

Security & disclaimer

This MCP is read-only: it audits, analyses and recommends. It never submits URLs to indexing, modifies sites, responds to reviews or changes listings. Per Google's guidance it does not use the Indexing API for general content. Any future write action will require preview → dry-run → confirmation → audit. See SECURITY.md.

Develop

git clone https://github.com/measure-mcp/measure-organic-mcp.git
cd measure-organic-mcp
uv sync --all-extras
uv run ruff check . && uv run mypy . && uv run pytest

Ecosystem

measure-sdk	Shared core: domain models, enums, Health Score, infra.
measure-analytics-mcp	GA4, GTM, BigQuery, Consent, Server-Side, Data Quality.
measure-paid-media-mcp	Google Ads, Meta, LinkedIn, TikTok, Microsoft, CM360.
measure-organic-mcp	This product (SEO · ASO · GEO).

See CHANGELOG.md · ROADMAP.md · SECURITY.md · CONTRIBUTING.md · CODE_OF_CONDUCT.md.

License

Apache-2.0.