# AltoRank MCP server
> Run SEO readiness audits, Search Console reads, keyword research and article drafts that land in a human review queue.
- Listing: https://mcp.tc/i/altorank
- Connect: use the server's own URL `https://app.altorank.co/api/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Marketing & SEO](https://mcp.tc/c/marketing-seo)
- Vendor: AltoRank
- Homepage:
- Docs:
- Repository:
## About
AltoRank is an open-source AI SEO content engine. Through its MCP server an assistant can audit a domain, read Google Search Console data, research keywords, check quota and create article drafts in a workspace. Drafts go to a review queue. No tool approves or publishes an article; only a person or a rule set by a named member can do that.
The hosted endpoint at https://app.altorank.co/api/mcp uses Streamable HTTP. Clients sign in with OAuth 2.0 (PKCE, dynamic client registration), and an owner or admin chooses the scopes (read, generate, write). An API key sent as a Bearer token also works. The project can be self-hosted under AGPL-3.0.
## What it can do
- Run domain readiness audits
- Read Google Search Console data
- Research keywords
- Create SEO article drafts into a review queue
- List workspaces and check quota
- Retry a failed publish of an already approved article
## Example prompts
- "Run a readiness audit on my domain and list the failing checks."
- "Pull my top Search Console queries for the last 28 days."
- "Research keywords around 'project management software' and draft an article."
- "How much of my AltoRank quota is left this month?"
## Install
### Claude Code
1. Run this in a terminal, in your project folder:
```bash
claude mcp add --transport http altorank https://app.altorank.co/api/mcp
```
2. Start Claude Code, type `/mcp`, pick **altorank** and choose **Authenticate**. A browser window opens for the AltoRank sign-in.
Add `--scope user` to make it available in every project, not just this one.
### Claude Desktop
1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.
2. Name it **AltoRank** and paste this URL:
```url
https://app.altorank.co/api/mcp
```
3. Click **Add**, then **Connect**, and sign in when AltoRank asks.
Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.
### claude.ai
1. Open the connector form on claude.ai. This button fills in the name and URL for you:
[Add to claude.ai]() (opens connector settings)
2. Check that the URL reads `https://app.altorank.co/api/mcp` and click **Add**.
3. Click **Connect** and sign in when AltoRank asks.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.
### ChatGPT
1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.
2. Enter a name for the server.
3. Under **Connection**, paste `https://app.altorank.co/api/mcp` as the server URL, then for authentication choose **OAuth**. ChatGPT sends you to AltoRank to sign in.
4. Check **I understand and want to continue**, then select **Create as a plugin**.
Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).
### Cursor
[Add to Cursor]() (opens Cursor)
Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):
`mcp.json`:
```json
{
"mcpServers": {
"altorank": {
"url": "https://app.altorank.co/api/mcp"
}
}
}
```
Cursor shows **Needs authentication** next to the server. Click the button beside it to sign in.
### VS Code
[Install in VS Code]() (opens VS Code)
Or from a terminal:
```bash
code --add-mcp '{"name":"altorank","type":"http","url":"https://app.altorank.co/api/mcp"}'
```
Or commit it to the repo in `.vscode/mcp.json`:
`.vscode/mcp.json`:
```json
{
"servers": {
"altorank": {
"type": "http",
"url": "https://app.altorank.co/api/mcp"
}
}
}
```
VS Code asks you to sign in the first time the server starts.
### Devin Desktop
1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):
`mcp_config.json`:
```json
{
"mcpServers": {
"altorank": {
"serverUrl": "https://app.altorank.co/api/mcp"
}
}
}
```
2. Refresh the MCP server list in Cascade and sign in when asked.
Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.
### Codex
```bash
codex mcp add altorank --url https://app.altorank.co/api/mcp
codex mcp login altorank
```
Or edit `~/.codex/config.toml` directly:
`config.toml`:
```toml
[mcp_servers.altorank]
url = "https://app.altorank.co/api/mcp"
```
### Gemini CLI
```bash
gemini mcp add --transport http altorank https://app.altorank.co/api/mcp
```
Then, inside Gemini CLI, run `/mcp auth altorank` to sign in.
This adds it to the current project. Add `-s user` to use it everywhere.
### Any client
Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.
```json
{
"mcpServers": {
"altorank": {
"type": "http",
"url": "https://app.altorank.co/api/mcp"
}
}
}
```
Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.
Client only starts local servers? Bridge it with `npx -y mcp-remote https://app.altorank.co/api/mcp`.
## Details
- Server version: 0.3.0
- Last checked: 2026-11-10 (reachable, asks for credentials)
- Listed: 2026-11-07
- Updated: 2026-11-07
---
Source: https://mcp.tc/i/altorank (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report