MCP Tools Reference
Every MCP tool with its real input schema and required scope — generated from the server definitions.
These tools are served by the AIEO.ee MCP endpoint (POST /mcp, streamable HTTP, Bearer API key).
This page is generated from the same definitions the server registers — it cannot drift.
Connect instructions: see the Developer Guide.
list_projects
List the projects (websites) in this AIEO.ee organization with their IDs.
Scope: read
No parameters.
query_rankings
Get tracked keywords with current/previous Google positions, volume, difficulty and intent. Optional substring search.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
search | string | no | substring filter on keyword |
limit | integer (min 1, max 100) | no | max rows (default 25) |
query_ai_visibility
Get AI answer-engine visibility for the project: mention rate, citation rate, share of voice per brand, per-engine breakdown.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
days | integer (min 1, max 90) | no | lookback window in days (default 14) |
analyze_citations
Analyze which domains AI engines cite for this project's tracked prompts — reveals why competitors get cited instead of you.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
days | integer (min 1, max 90) | no | lookback window in days (default 14) |
find_content_gap
List content gaps: keywords where competitors rank top-10 but the project ranks >15 or not at all, with estimated traffic.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
analyze_competitor
Competitor benchmark: SEO overlap vs AI share of voice. Optional brandId to see keywords they win and you don't.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
brandId | string | no | specific competitor brand id |
get_audit_issues
Latest technical SEO audit issues (broken links, missing titles/meta, schema gaps) with severity and fixes.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
generate_seo_plan
Produce a prioritized growth plan combining GEO + SEO + content + technical findings, with the project's Growth Score.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
discover_competitors
Discover competitor domains that repeatedly share Google SERPs with this project (from stored SERP snapshots). Returns overlap keywords, volume, average position and a competition score.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
days | integer (min 7, max 90) | no | snapshot lookback window in days (default 30) |
min_days | integer (min 1, max 10) | no | minimum co-occurrence days to count as competitor (default 2) |
analyze_competitor_domain
Drill into one discovered competitor domain: the keywords it co-occurs with, volumes and both sides' positions.
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
domain | string | yes | competitor domain, e.g. kinsta.com |
generate_content_brief
Generate a full SEO content brief (outline, entities, FAQ) for a content gap (WRITE — requires a key with write scope). Paid: needs a subscription and draws on the usage balance at actual token cost (about $0.012). Find gap IDs with find_content_gap.
Scope: write — requires an API key with write scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |
gap_id | string | yes | Content gap ID from find_content_gap |
get_ai_readiness_report
Latest AI readiness report for a project's primary domain: can AI crawlers and agents reach and read the site (robots.txt and AI crawler rules, content without JavaScript, structured data, llms.txt, agent protocols). Returns status, scores and the items to fix. Read-only: it never starts a check — run one from the dashboard (free).
Scope: read
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (omit to use the org's first project; an id that is not in this organization is an error — list valid ids with list_projects) |