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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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 (defaults to the org's first project; list them 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). 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 (defaults to the org's first project; list them with list_projects) |
gap_id | string | yes | Content gap ID from find_content_gap |