ranklogs
Server Details
Ranklogs brings SEO and AI-search visibility into your AI client. Ask whether ChatGPT and Google's AI answers name your brand when customers ask for recommendations, see which competitors get named instead, check keyword rankings, audit a site, and pull backlink and content data — all as tools your assistant can call directly.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Score is being calculated. Check back soon.
Available Tools
27 toolsadd_ai_promptAdd an AI visibility promptIdempotentInspect
Track a new question across AI assistants for a Ranklogs project.
Requires a connection with write access. A project tracks up to 20 prompts, and an existing prompt is not added twice, so repeating a call is safe. Results appear after the next weekly AI visibility run.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The question to track across AI assistants. | |
| project_id | Yes | Ranklogs project id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| added | Yes | |
| reason | No | |
| quota_remaining | Yes |
add_keywords_to_projectAdd keywords to a projectIdempotentInspect
Start tracking new keywords on a Ranklogs project.
Requires a connection with write access. Keywords already tracked are skipped, so repeating a call is safe. Positions appear after the next daily rank check — this does not run an immediate check. Adding is limited by the plan keyword allowance; whatever fits is added and the rest come back as skipped.
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes | Keywords to start tracking. Duplicates are ignored. | |
| project_id | Yes | Ranklogs project id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| added | Yes | |
| skipped | Yes | |
| added_count | Yes | |
| skipped_count | Yes | |
| quota_remaining | Yes |
analyze_competitor_domainAnalyze a competitor domainRead-onlyInspect
Analyze a competitor domain: organic/paid footprint, estimated traffic and traffic value, position split, and their top-ranking keywords.
Pass project_id (a ranking id from list_projects) to overlay winnability and get prioritized recommendations; omit it and recommendations come back empty. May use lookups, up to 3 fetches cold — accounts on the legacy KR add-on are charged one daily research credit per call even on cache hits, so this is never free for them.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Competitor root domain, e.g. competitor.com | |
| project_id | No | Your ranking id from list_projects — enables the winnability overlay AND recommendations (omit and recommendations come back empty). | |
| language_code | No | en | |
| location_code | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| notes | Yes | |
| domain | Yes | |
| verdict | Yes | |
| overview | Yes | |
| top_keywords | Yes | |
| recommendations | Yes | |
| lookups_remaining | Yes |
generate_content_briefGenerate a content briefInspect
Run a content analysis on one page for one search term: scores it against the pages actually ranking and produces a working brief.
Uses 1 of the plan's monthly content analyses. Takes about a minute — fetch the result with get_content_brief.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page to analyze. | |
| keyword | Yes | The search term to score the page against. | |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| check | Yes | |
| reason | Yes | |
| run_id | Yes | |
| started | Yes | |
| verdict | Yes | |
| target_id | Yes | |
| project_id | Yes |
generate_reportGenerate a branded PDF reportRead-onlyInspect
Produce a branded PDF report for a project: the full project report, or a web audit as a complete report or an issues-only list.
project_id is a ranking id from list_projects. Choose kind: full for the whole project report, audit_full for the complete web audit, or audit_issues for the issues-only list. Returns a one-time download link, or a local file path when run locally. Requires the report feature enabled on the account. (free — cached render)
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Which branded PDF: full = the whole project report; audit_full = complete web audit; audit_issues = the audit issues list only. | full |
| period | No | Report window in days (7, 30 or 90) — used by kind=full | |
| sections | No | Subset for kind=full; omit for all | |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| kind | Yes | |
| filename | Yes | |
| file_path | No | |
| expires_at | No | |
| size_bytes | Yes | |
| download_url | No |
generate_schemaGenerate JSON-LD schema markupRead-onlyInspect
Generate valid schema.org JSON-LD structured data for any of 13 common content types, ready to drop into a page.
Supported types: FAQPage, BreadcrumbList, Article, LocalBusiness, Organization, Person, VideoObject, WebSite, Product, HowTo, Recipe, Event, and JobPosting. Required fields per type are validated and errors name exactly what is missing so you can fix and retry. (free, no API call)
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | The schema type to generate | |
| fields | Yes | Type-specific fields — required fields are validated and errors tell you exactly what is missing. Required per type: FAQPage qa[].q+a; BreadcrumbList items[].name (≥2); Article headline; LocalBusiness/Organization/Person/Product name; VideoObject name+description+thumbnailUrl+uploadDate; WebSite name+url; HowTo name+steps[].text; Recipe name+ingredients[].item+steps[].text; Event name+startDate; JobPosting title+description+datePosted+orgName. |
Output Schema
| Name | Required | Description |
|---|---|---|
| type | Yes | |
| json_ld | Yes | |
| jsonld_object | Yes |
get_account_statusAccount status & quotaRead-onlyInspect
Your Ranklogs plan/tier, lookups balance and monthly allowance, and which Ranklogs features are enabled.
This is the quota pre-check tool: check here before planning research-heavy work. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| plan | Yes | |
| lookups | Yes | |
| verdict | Yes | |
| features_enabled | Yes | |
| lookups_remaining | Yes |
get_ai_citationsAI citations & sourcesRead-onlyInspect
Which sources AI answer engines cite for one project: top cited pages tagged yours, competitor, or third-party, plus the corroboration gap.
project_id is a ranking id from list_projects. The corroboration gap is third-party domains that cite rivals in AI answers while you're absent — your publish/target list. Pass prompt_id for full per-engine evidence on one tracked prompt. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt_id | No | A tracked prompt id — returns per-engine full answers + citations for it | |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| notes | Yes | |
| verdict | Yes | |
| evidence | Yes | |
| top_pages | Yes | |
| corroboration_gap | Yes |
get_ai_visibilityAI search visibilityRead-onlyInspect
How visible one project is across AI answer engines: share of AI voice, presence and citation rate, and rank among tracked competitors.
project_id is a ranking id from list_projects. Share of AI voice, presence, and citation rate are aggregate figures measured across ChatGPT, Gemini, Google AI Overviews, and Perplexity, broken down per engine. Per-engine figures are share of AI voice and cited/named/absent counts, not a per-engine citation-rate split. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| window | No | Reporting window: all history, last 90 days, or last 30 days | all |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| notes | Yes | |
| window | Yes | |
| verdict | Yes | |
| confidence | Yes | |
| per_engine | Yes | |
| sov_change | Yes | |
| competitors | Yes | |
| presence_pct | Yes | |
| citation_rate | Yes | |
| share_of_voice | Yes | |
| rank_among_competitors | Yes |
get_audit_issuesWeb audit issuesRead-onlyInspect
Web audit issues for a project: a severity-filtered list, or drill into one issue’s affected pages and fix steps.
project_id is a ranking id from list_projects. Omit issue_key for the severity-filtered list (each issue carries its own how-to-fix); pass issue_key to drill into that issue’s affected pages and full fix steps. Filter the list with severity (error, warning, or notice); page through detail results with page. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| severity | No | ||
| issue_key | No | ||
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| area | No | |
| mode | Yes | |
| label | No | |
| total | No | |
| issues | No | |
| severity | No | |
| issue_key | No | |
| truncated | No | |
| how_to_fix | No | |
| project_id | Yes | |
| affected_pages | No |
get_audit_summaryWeb audit summaryRead-onlyInspect
Web audit health summary for a project: site health score, its change since the last crawl, and the top-3 prioritized fixes.
project_id is a ranking id from list_projects. The fix-next verdict explains why each item matters and which area it touches, alongside quick wins, pages at risk, and what was fixed since the last crawl. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| fixed | Yes | |
| fix_next | Yes | |
| project_id | Yes | |
| quick_wins | Yes | |
| since_last | Yes | |
| health_delta | Yes | |
| health_score | Yes | |
| pages_at_risk | Yes |
get_backlink_profileBacklink profileRead-onlyInspect
Backlink profile summary for a project: Domain Score, total backlinks, referring domains, new/lost counts, spam score, and anchor health.
project_id is a ranking id from list_projects. Results are prioritized with risk notes flagging what needs attention. (may use lookups)
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| new_count | Yes | |
| lost_count | Yes | |
| project_id | Yes | |
| risk_notes | Yes | |
| spam_score | Yes | |
| domain_score | Yes | |
| anchor_health | Yes | |
| total_backlinks | Yes | |
| low_balance_note | No | |
| lookups_remaining | Yes | |
| referring_domains | Yes |
get_content_action_planContent action planRead-onlyInspect
The project's prioritized to-do list: what to brief, which AI prompts you're losing, what's technically at risk — ordered by business impact. Computed nightly from the project's own data.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| kpis | Yes | |
| cards | Yes | |
| verdict | Yes | |
| project_id | Yes |
get_content_briefContent briefRead-onlyInspect
A finished content brief for one target page: 0–100 score against the pages actually ranking, terms to add, questions to answer, suggested outline and internal links.
| Name | Required | Description | Default |
|---|---|---|---|
| target_id | Yes | Content target id from get_content_targets |
Output Schema
| Name | Required | Description |
|---|---|---|
| url | Yes | |
| brief | Yes | |
| score | Yes | |
| status | Yes | |
| keyword | Yes | |
| verdict | Yes | |
| scored_at | Yes | |
| target_id | Yes | |
| latest_run | Yes |
get_content_targetsContent optimization targetsRead-onlyInspect
The pages under content optimization for a project, with their scores and the monthly analysis allowance.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| targets | Yes | |
| verdict | Yes | |
| allowance | Yes | |
| project_id | Yes |
get_keyword_battlegroundKeyword battleground (head-to-head)Read-onlyInspect
A strictly pairwise head-to-head between your domain and one rival: keyword intersection with both positions, plus the gap list.
The gap list is keywords the rival ranks for that you don't — your publish/target list. Provide domain_a, or project_id to use your project domain. May use lookups; this is strictly pairwise, so call it once per rival. Legacy KR add-on accounts are charged a daily research credit per call even on cache hits.
| Name | Required | Description | Default |
|---|---|---|---|
| domain_a | No | Your domain; defaults to the project domain when project_id is given | |
| domain_b | Yes | The rival domain to compare against, e.g. rival.com | |
| project_id | No | Your ranking id from list_projects — used to resolve your domain (provide domain_a OR project_id). | |
| language_code | No | en | |
| location_code | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| rows | Yes | |
| notes | Yes | |
| verdict | Yes | |
| domain_a | Yes | |
| domain_b | Yes | |
| gap_list | Yes | |
| overlap_count | Yes | |
| lookups_remaining | Yes |
get_keyword_rankingsKeyword rankingsRead-onlyInspect
Keyword positions and KPIs for one project: visibility, traffic estimate, top-3/top-10 counts, and per-keyword detail.
Per-keyword detail includes position, change, best URL, intent, volume, and Keyword Score. Works for web, local and YouTube projects (tracking type is detected automatically). project_id is a ranking id from list_projects. Filter with query, order with sort (position/change/volume/traffic), cap with limit (max 50). Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | position | |
| limit | No | ||
| query | No | ||
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| kpis | Yes | |
| total | Yes | |
| project | Yes | |
| verdict | Yes | |
| keywords | Yes | |
| truncated | Yes | |
| tracking_note | Yes |
get_new_lost_backlinksNew / lost backlinksRead-onlyInspect
New and lost backlinks for a project, capped 25 per side, each with Domain Score, anchor text, and follow status.
project_id is a ranking id from list_projects. (may use lookups)
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| status | No | both | |
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| status | Yes | |
| new_links | Yes | |
| lost_links | Yes | |
| project_id | Yes | |
| honesty_note | Yes | |
| fallback_used | Yes | |
| low_balance_note | No | |
| lookups_remaining | Yes |
get_outreach_recommendationsBacklink outreach recommendationsRead-onlyInspect
Backlink outreach, protect, and fix recommendations for a project.
project_id is a ranking id from list_projects. Pass competitor_domain to get link-gap domains — domains that link to a rival but not you — ranked as outreach targets. (may use lookups)
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| competitor_domain | No | A rival root domain, e.g. competitor.com — switches to link-gap mode: domains that link the rival but not you, ranked as outreach targets. |
Output Schema
| Name | Required | Description |
|---|---|---|
| mode | Yes | |
| cards | No | |
| project_id | Yes | |
| gap_domains | No | |
| low_balance_note | No | |
| competitor_domain | No | |
| lookups_remaining | Yes |
get_project_overviewProject overviewRead-onlyInspect
The briefing for one project: health, visibility, top movers, and the highest-priority things to fix now.
project_id is a ranking id from list_projects — call list_projects first. If the premium briefing isn't enabled for the account, this returns base health/visibility/backlink metrics instead and says so. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| health | Yes | |
| movers | Yes | |
| project | Yes | |
| verdict | Yes | |
| degraded | Yes | |
| insights | Yes | |
| backlinks | Yes | |
| visibility | Yes | |
| degraded_note | Yes |
get_prompt_gap_briefAI prompt gap briefRead-onlyInspect
The gap brief for one AI prompt: the answer an assistant could quote, what the currently-cited pages have that this site doesn't, and the schema to add. null until win_prompt has run.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt_id | Yes | A tracked AI prompt id, from get_ai_visibility's prompt matrix or add_ai_prompt | |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| prompt | Yes | |
| verdict | Yes | |
| allowance | Yes | |
| gap_brief | Yes | |
| latest_run | Yes | |
| project_id | Yes | |
| gap_brief_at | Yes |
get_ranking_alertsRanking alerts (movements)Read-onlyInspect
Threshold-crossing ranking events for one project over the last N days (7–90): keywords entering/leaving top 3/10/100 and big gains/drops.
Events are annotated with known Google update dates. Honest scope: these are computed movements, not user-configured alert rules — Ranklogs has no saved-alerts feature yet. project_id is a ranking id from list_projects. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| project_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| total | Yes | |
| events | Yes | |
| by_type | Yes | |
| project | Yes | |
| verdict | Yes | |
| truncated | Yes | |
| window_days | Yes |
get_topic_clustersTopic clustersRead-onlyInspect
Groups keyword ideas for a seed into topic clusters, each with a keyword count, total search volume, and a suggested pillar page.
The pillar page suggestion is the highest-volume member of the cluster. The interactive cluster map lives in the Ranklogs app; this tool returns the data behind it. Pass project_id (a ranking id from list_projects) to overlay tracked keywords. (may use lookups)
| Name | Required | Description | Default |
|---|---|---|---|
| seed | Yes | ||
| limit | No | ||
| project_id | No | ||
| language_code | No | en | |
| location_code | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| seed | Yes | |
| clusters | Yes | |
| low_balance_note | No | |
| lookups_remaining | Yes |
list_projectsList projectsRead-onlyInspect
List your Ranklogs projects, flattened into rows: project_id, domain, tracking type, engine/locale, keyword count, and top-line movement.
Each row's project_id is a ranking id you pass to other tools. tracking_type is web, local, or YouTube. Demo/sample projects are flagged is_demo — do not treat them as the customer site. Call this tool first to get valid project_id values before calling anything else. Free — calling it never consumes lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| total | Yes | |
| verdict | Yes | |
| projects | Yes | |
| truncated | Yes |
research_keywordsKeyword researchRead-onlyInspect
Keyword research across modes (overview, ideas, suggestions, related): volume, difficulty, intent, CPC and an opportunity score.
term is your seed/keyword (mapped per mode). source google|amazon is only valid for overview & suggestions. Pass project_id (a ranking id from list_projects) to overlay tracked keywords. Results include honest from_cache/stale flags and the remaining-lookups balance. (may use lookups)
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| term | Yes | ||
| limit | No | ||
| source | No | ||
| project_id | No | ||
| language_code | No | en | |
| location_code | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| mode | Yes | |
| rows | Yes | |
| term | Yes | |
| stale | Yes | |
| from_cache | Yes | |
| low_balance_note | No | |
| lookups_remaining | Yes | |
| opportunity_summary | Yes |
win_promptWin an AI promptInspect
Run a gap analysis on an AI prompt the site is absent from: reads the pages AI assistants actually cite and briefs what it takes to become the cited answer.
Optionally compare against one of the site's own pages. Uses 1 monthly content analysis — fetch the result with get_prompt_gap_brief.
| Name | Required | Description | Default |
|---|---|---|---|
| own_url | No | Optional: one of the site's own pages to compare against the cited pages. | |
| prompt_id | Yes | A tracked AI prompt id, from get_ai_visibility's prompt matrix or add_ai_prompt | |
| project_id | Yes | Ranking id from list_projects |
Output Schema
| Name | Required | Description |
|---|---|---|
| check | Yes | |
| reason | Yes | |
| run_id | Yes | |
| started | Yes | |
| verdict | Yes | |
| prompt_id | Yes | |
| project_id | Yes |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to access SurfRank's AI visibility analytics platform through 24 tools. It allows agents to run AI-visibility reports, research keywords, track competitors, and manage projects directly from chat interfaces.249MIT
- AlicenseNot gradedqualityBmaintenanceEnables auditing AI search visibility: checks site readiness for AI crawlers and measures whether ChatGPT, Gemini, and Perplexity recommend your site, including verbatim answers and citation gap analysis.7034AGPL 3.0
- AlicenseCqualityDmaintenanceConnects AI assistants to SE Ranking's SEO and project management APIs to enable natural language queries for keyword research, backlink analysis, and technical audits. It supports comprehensive tasks including competitive analysis, domain traffic tracking, and AI search visibility monitoring.100Apache 2.0
- -licenseNot gradedqualityCmaintenanceEnables AI assistants to perform comprehensive SEO and GEO measurements, including site audits, keyword research, ranking tracking, and brand visibility analysis across search engines and generative AI platforms.