RankUp MCP

All-in-one SEO toolkit MCP (Model Context Protocol) for Claude, Cursor, and other AI assistants.

Features

• 26 SEO Tools - Keyword research, content writing, optimization, and more
• AI Content Writing - Full article generation with SERP research
• Multi-Platform Publishing - WordPress, Ghost, webhooks
• Image Generation - fal.ai FLUX Schnell integration
• Session Management - Save and resume content workflows
• Interactive CLI - Simple wizards for setup and configuration

Quick Start

1. Get API Key

Sign up at rankup.tools to get your free API key.

2. Install & Setup

npx rankup setup

This configures your API key and tests the connection. Config is saved to ~/.rankup/.

3. Add to Your AI Client

Claude Code:

claude mcp add rankup -- npx -y rankup

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "rankup": {
      "command": "npx",
      "args": ["-y", "rankup"]
    }
  }
}

Cursor (Settings → MCP Servers):

{
  "mcpServers": {
    "rankup": {
      "command": "npx",
      "args": ["-y", "rankup"]
    }
  }
}

4. Configure Integrations (Optional)

npx rankup secrets

Interactive wizard to configure:

• Image Generation - fal.ai API key for AI images
• WordPress - Publish directly to your WordPress site
• Ghost - Publish to Ghost blogs
• Webhooks - Make, n8n, Zapier, Slack integrations

CLI Commands

| Command | Description | |---------|-------------| | npx rankup | Start MCP server | | npx rankup setup | Run setup wizard | | npx rankup secrets | Configure API keys & integrations | | npx rankup test | Test API connection & view usage | | npx rankup session | View current session | | npx rankup clear | Clear session or config data | | npx rankup update | Clear cache & update to latest |

Available Tools

SEO Research

| Tool | Description | |------|-------------| | keyword_research | Find keywords with SERP analysis, related searches, People Also Ask | | serp_tracker | Track domain ranking for a keyword | | page_speed | PageSpeed Insights performance metrics | | on_page_seo | On-page SEO audit (title, meta, headings, images) | | site_crawl | Crawl site structure following internal links |

Strategy & Planning

| Tool | Description | |------|-------------| | seo_strategy | Create comprehensive SEO strategies | | topical_map | Build topic clusters for authority | | content_calendar | Plan content schedules with prioritized keywords |

Content Creation

| Tool | Description | |------|-------------| | content_brief | Detailed content brief with outline and competitor analysis | | content_write | Write SEO-optimized articles with SERP research | | image_prompt | Generate prompts for AI images (hero, section, diagram) | | generate_image | Create images with FLUX Schnell via fal.ai |

Content Optimization

| Tool | Description | |------|-------------| | quality_check | Pre-publish QA - SEO, grammar, content quality scoring | | geo_optimize | Optimize for AI search engines (ChatGPT, Perplexity, SGE) | | internal_links | Find internal linking opportunities with anchor text | | schema_generate | Create JSON-LD schema markup (Article, FAQ, HowTo, Product) |

Publishing

| Tool | Description | |------|-------------| | save_content | Save content to session for later use | | publish_content | Publish to all configured platforms at once | | publish_wordpress | Direct WordPress publishing via REST API | | publish_ghost | Direct Ghost publishing via Admin API | | send_webhook | Send to automation platforms (Make, n8n, Zapier, Slack) |

Session Management

| Tool | Description | |------|-------------| | full_pipeline | Complete content workflow guide | | get_session | View current session state | | clear_session | Clear all session data | | list_content | List all saved content | | load_content | Load specific content by ID |

Configuration Files

All configuration is stored in ~/.rankup/:

~/.rankup/
├── config.json         # API key & proxy URL
└── credentials.json    # Integration credentials

credentials.json Example

{
  "image_provider": "fal",
  "fal": {
    "api_key": "your-fal-key"
  },
  "wordpress": {
    "site_url": "https://your-site.com",
    "username": "your-username",
    "app_password": "your-application-password"
  },
  "ghost": {
    "site_url": "https://your-ghost-site.com",
    "admin_api_key": "your-admin-api-key"
  },
  "webhooks": {
    "webhook_url": "https://hook.make.com/xxx",
    "slack_url": "https://hooks.slack.com/services/xxx"
  }
}

WordPress Integration

1. Go to Users → Edit User → Application Passwords in your WordPress admin
2. Create a new application password for RankUp
3. Run npx rankup secrets and select WordPress Publishing
4. Enter your site URL, username, and the application password

Ghost Integration

1. Go to Settings → Integrations → Custom Integration in your Ghost admin
2. Create a new integration and copy the Admin API Key
3. Run npx rankup secrets and select Ghost CMS Publishing
4. Enter your Ghost URL and the Admin API Key

Updating

To update to the latest version:

npx rankup update

This clears the npx cache and ensures you get the newest version on next run.

Plans

| Feature | Free | Pro | |---------|------|-----| | Keyword research | 100/mo | 2,000/mo | | AI article writing | 20/mo | 500/mo | | PageSpeed analysis | 50/mo | 1,000/mo | | Image generation | BYO fal.ai key | BYO fal.ai key | | Rate limit | 30/min | 120/min |

Support

• Docs: rankup.tools
• Issues: GitHub Issues

Development

git clone https://github.com/akdenizemirhan/rankup.git
cd rankup
npm install
npm run build:mcp

Project Structure

rankup/
  packages/
    mcp/                  # npm package (rankup)
      src/
        cli/              # CLI commands (setup, test, secrets, etc.)
        services/         # API clients (serper, gemini, pagespeed, fal)
        tools/            # 26 MCP tools
        utils/            # Shared utilities
    worker/               # Cloudflare Worker (API proxy)
      src/
        routes/           # Proxy route handlers
        middleware/        # Auth, rate limit, usage tracking
        db/               # D1 schema & queries

License

MIT