Skip to main content
Glama

outrank-mcp

License: MIT Python MCP

MCP server for Outrank, the autonomous SEO content engine built by Tibo Maker. 5 tools for AI agents to verify credits, list managed website products, queue keyword research, generate SEO long-form articles (with optional auto-publish to the connected CMS), and fetch finished article content.

As of May 2026, Outrank does not ship an official MCP server, and no community-built attempt exists. Pure GREEN whitespace.

The 5 tools

Tool

Purpose

check_auth_and_credits

Verify the API key and retrieve remaining article-generation credits

list_products

List active website products (managed sites) in the organization

generate_keywords

Queue keyword cluster research for a product on a broad topic

generate_article

Generate an SEO long-form article targeted at a specific keyword (optional auto-publish)

get_article_content

Fetch the raw markdown + HTML content for a finished article

Related MCP server: seo-mcp

Install

pip install outrank-mcp

Configure

export OUTRANK_API_KEY="outr_live_your-outrank-api-key"

Get your API key in your Outrank Dashboard under Settings -> API keys. Keys are prefixed outr_live_. The MCP sends the key as a Bearer token; keep it server-side only.

Use with Claude Desktop

{
  "mcpServers": {
    "outrank": {
      "command": "outrank-mcp",
      "env": {
        "OUTRANK_API_KEY": "outr_live_your-outrank-api-key"
      }
    }
  }
}

Restart Claude Desktop. The 5 Outrank tools are now available.

Use case: autonomous SEO content loop

Typical agent flow:

  1. Call check_auth_and_credits() to confirm the API key is valid and there are remaining credits for article generation

  2. Call list_products() to see which managed websites you can target

  3. Call generate_keywords(product_id, topic) to queue keyword research on a broad topic

  4. Call generate_article(product_id, keyword, auto_publish=false) to generate a long-form SEO article (set auto_publish=true to push to the connected CMS automatically)

  5. Call get_article_content(article_id) to fetch the finished markdown + HTML for review or further agent processing

The full content loop runs through these 5 tools without leaving the agent.

Architecture

  • Public MIT-licensed wrapper around the Outrank REST API v1

  • Async HTTP via httpx

  • pydantic v2 input validation

  • Bearer token auth, server-side only

  • Rate-limit aware (Outrank caps at 120 RPM and 10,000 RPD per key; the client reads Retry-After + X-RateLimit-* headers on 429 responses)

Development

git clone https://github.com/NoBanks/outrank-mcp.git
cd outrank-mcp
pip install -e ".[dev]"
pytest

License

MIT. See LICENSE.

Author

Ryan Hammer (NoBanks). Solo founder + engineer. Built this and 13 other MCP servers as part of a sprint to expose AI agent rails for the products and platforms shipping daily. Built outrank-mcp specifically as a same-day material reply to Tibo Maker's May 28 2026 newsletter asking which manual work people want AI agents to handle.

Open to AI engineering roles, contract or full-time, remote-only.

Available Tools

5 tools
check_auth_and_creditsA

Verify the Outrank API key and retrieve remaining article-generation credits.

Inputs: no named parameters.

generate_articleB

Generate a long-form SEO article targeted at a specific keyword, with optional auto-publish to the connected CMS.

Inputs: product_id (required), keyword (required), language, auto_publish.

generate_keywordsB

Queue keyword cluster research for a product on a broad topic.

Inputs: product_id (required), topic (required), languages.

get_article_contentA

Fetch the raw markdown and HTML content for a finished article by its ID.

Inputs: article_id (required).

list_productsA

List all active website products in the Outrank organization.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct function: authentication, article generation, keyword research, content retrieval, and product listing. No overlapping purposes.

    Naming Consistency4/5

    Tools follow a verb_noun pattern (generate_article, get_article_content, list_products), with check_auth_and_credits being a minor deviation using 'and'.

    Tool Count5/5

    Five tools is well-scoped for an SEO article generation server, covering authentication, generation, research, retrieval, and product listing without unnecessary bloat.

    Completeness3/5

    Missing operations like listing finished articles, updating articles, or deleting them. The get_article_content tool requires knowing an ID, but there is no way to discover articles otherwise.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for AgentMinds collective intelligence platform, enabling AI agents to scan websites for security/SEO/performance issues, pull personalized recommendations, and share findings across the network.
      7
      54 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that gives AI assistants live access to Google Search Console and Bing Webmaster Tools for search performance, indexing, keyword research, and crawl health analysis directly in the chat.
      10
      13 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An agent-friendly MCP server for the GeoRanker High-Volume API, enabling SEO rank tracking and keyword management through natural language.
      25 npm
      1
      MIT