> ## Documentation Index > Fetch the complete documentation index at: https://docs.crakseo.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > For SEO data and indexing, start with /seo-mcp/overview.md and /seo-mcp/connect.md, then read the focused server reference. > The documentation search MCP at https://docs.crakseo.com/mcp searches documentation only. Product tools use https://crakseo.com/mcp/. > Check tool availability and API credit balance before paid calls. Request owner approval for paid indexing. Never invent prices, indexing guarantees or directory approval. # Connect a CrakSEO MCP server > Choose an SEO MCP endpoint, authenticate with OAuth or an API key, verify a free first call and troubleshoot client setup without spending credits. ## 1. Choose a focused endpoint Use the server for the job your AI needs to do. All endpoints use **Streamable HTTP**; these are remote servers, not npm packages to run locally. | Server | Endpoint | Tools | Billing | | - | - | - | - | | [SEO MCP](https://docs.crakseo.com/mcp-servers/seo.md) | `https://crakseo.com/mcp/seo` | 20 | Pay as you go (API credits) | | [Google SERP API MCP](https://docs.crakseo.com/mcp-servers/serp-api.md) | `https://crakseo.com/mcp/serp-api` | 6 | Pay as you go (API credits) | | [Keyword Research MCP](https://docs.crakseo.com/mcp-servers/keyword-research.md) | `https://crakseo.com/mcp/keyword-research` | 5 | Pay as you go (API credits) | | [Backlink Checker MCP](https://docs.crakseo.com/mcp-servers/backlinks.md) | `https://crakseo.com/mcp/backlinks` | 4 | Pay as you go (API credits) | | [Google Rank Tracker MCP](https://docs.crakseo.com/mcp-servers/rank-tracker.md) | `https://crakseo.com/mcp/rank-tracker` | 5 | Pay as you go (API credits) | | [SEO Site Audit MCP](https://docs.crakseo.com/mcp-servers/site-audit.md) | `https://crakseo.com/mcp/site-audit` | 3 | Pay as you go (API credits) | | [Local SEO MCP](https://docs.crakseo.com/mcp-servers/local-seo.md) | `https://crakseo.com/mcp/local-seo` | 3 | Pay as you go (API credits) | | [AI Search Visibility MCP](https://docs.crakseo.com/mcp-servers/ai-visibility.md) | `https://crakseo.com/mcp/ai-visibility` | 4 | Pay as you go (API credits) | | [URL Indexing MCP](https://docs.crakseo.com/mcp-servers/url-indexing.md) | `https://crakseo.com/mcp/url-indexing` | 5 | Free IndexNow and Bing; paid Google submission | | [Google Search Console MCP](https://docs.crakseo.com/mcp-servers/search-console.md) | `https://crakseo.com/mcp/search-console` | 8 | Free | Start with **Search Console + Bing** for your own sites, **URL Indexing** after publishing, or **SEO MCP** for a general research connection. Focused servers reduce the number of tools a client needs to load. > [!NOTE] > > `https://docs.crakseo.com/mcp` searches documentation. It is not a product endpoint. SEO tools live at `https://crakseo.com/mcp/`. ## 2. Add it to your client Follow the client-specific setup for OAuth support, configuration shape and secret storage: > **[Claude Code](https://docs.crakseo.com/quickstarts/claude-code.md)** > **[ChatGPT](https://docs.crakseo.com/quickstarts/chatgpt.md)** > **[Cursor](https://docs.crakseo.com/quickstarts/cursor.md)** > **[Codex](https://docs.crakseo.com/quickstarts/codex.md)** > **[VS Code and Copilot](https://docs.crakseo.com/quickstarts/vscode.md)** > **[Cline](https://docs.crakseo.com/quickstarts/cline.md)** > **[Gemini CLI](https://docs.crakseo.com/quickstarts/gemini-cli.md)** > **[Grok](https://docs.crakseo.com/quickstarts/grok.md)** > **[Muse](https://docs.crakseo.com/quickstarts/muse.md)** For example, in Claude Code: ```bash theme={null} claude mcp add --transport http crakseo-search-console https://crakseo.com/mcp/search-console ``` A custom connection works independently of marketplace approval. Client plan requirements and support for custom connectors may differ. ## 3. Authenticate **OAuth:** add the URL without a key, open your client's MCP authentication flow and sign in to CrakSEO. Review the scopes before authorizing. **API key:** create a scoped key in [Settings > API keys](https://crakseo.com/app/settings/keys). Clients that support request headers can send `Authorization: Bearer YOUR_CRAKSEO_API_KEY`. Use the client's secret storage or an environment variable; never commit a key. | Server family | Scopes | | - | - | | SEO data | `seo-data:read` | | URL indexing | `indexing:read`, `indexing:submit` | | Search Console and Bing | `console:read`, `console:write` | An API key or OAuth connection authenticates you to CrakSEO. It does **not** connect a Google or Bing property or authorize paid indexing spend. ## 4. Verify a free call first For an SEO data server, ask your assistant: ```text theme={null} Use CrakSEO get_api_credit_balance to check my connection and report the balance and whether data calls are enabled. Do not buy credits or call any paid tool. ``` This tool is available on the eight SEO data servers and is free. A successful tool response verifies authentication and tool execution without a supplier purchase. Read the response rather than assuming a nonzero balance or that data calls are enabled. For **Search Console**, call `list_search_console_properties` instead. If it returns `not_connected`, follow the connection link, sign in with the property owner and retry. No property access is granted just by installing the MCP server. For **URL Indexing**, call `get_indexing_account` to inspect the account without submitting URLs or approving spend. ## 5. Run the job with the right approval * **Research:** inspect the tool parameters on the focused reference page. Check current pricing and ask permission before a paid call. * **Free indexing:** use the free routes documented on [URL Indexing MCP](https://docs.crakseo.com/mcp-servers/url-indexing.md). Successful submission does not guarantee search-engine inclusion. * **Paid indexing:** call `quote_indexing_submission`, show the quote, and send the owner to the returned confirmation URL. Retry with the same `quoteId` and `idempotencyKey` after approval. The agent must not approve its own spend. Examples in the reference are illustrative JSON, not evidence of actual rankings, volumes or successful submissions. ## Troubleshooting | Symptom | Next step | | - | - | | `401` before authentication | Open the client's OAuth flow or check the bearer key. An unauthenticated challenge is expected; it is not a data result. | | `forbidden` | Reauthorize the required scopes or use a correctly scoped key. | | `not_connected` | Connect Google or Bing with access to the requested property. | | `disabled` | The deployment has not enabled the tool family. Buying credits does not enable it. | | `insufficient_credits` | Review current pricing before adding credits. Failed calls are not charged. | | `confirmation_required` | Have the account owner approve the exact paid-indexing quote. | | Tools missing | Confirm the product endpoint, reload the client and inspect its MCP tool list. | See [API credits](https://docs.crakseo.com/pricing/api-credits.md) for billing and [the tool reference](https://docs.crakseo.com/seo-mcp/overview.md) for the server catalog. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.