# Grandranker

> Grandranker is an SEO and AI-search-visibility platform. Track keywords and rankings,
> monitor visibility across AI answer engines (Google AI Overviews, ChatGPT, Perplexity,
> Claude, Gemini), and generate and publish SEO articles to your CMS.

## For developers and AI agents

Grandranker is agent-ready. Technical users can drive the product programmatically.

- REST API (OpenAPI): https://app.grandranker.com/api/v1 — docs at https://app.grandranker.com/docs
- MCP server (Model Context Protocol, Streamable HTTP): https://app.grandranker.com/mcp/grandranker
- Auth: Bearer API token (create one at https://app.grandranker.com/settings/api-tokens). Token scopes gate access.

### MCP

Connect any MCP client (Claude, Cursor, Copilot) to https://app.grandranker.com/mcp/grandranker with header
`Authorization: Bearer <token>`. Most tools take a `domain_id` argument — call `list_domains`
first to get one. Core tools: list_domains, list_keywords, add_keyword, research_keywords,
list_articles, get_article, generate_article, edit_article, publish_article,
get_ai_overview_visibility, get_rank_overview. Article generation and keyword research are
asynchronous — poll get_article / list_keywords for completion.