Reaudit MCP

An MCP Server to Control Your AI Visibility Through Reaudit.io

GitHub

Reaudit MCP Server

Access your Reaudit AI Visibility Platform data from AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients.

What is MCP?

The Model Context Protocol (MCP) is an open protocol that allows AI assistants to securely access external data sources and tools. With the Reaudit MCP server, you can ask your AI assistant questions about your AI visibility, SEO audits, and more.

Installation

Prerequisites

  • Node.js 18 or later
  • An active Reaudit subscription
  • Claude Desktop, Cursor, or another MCP-compatible client

Quick Start

  1. Install the package globally:
npm install -g @reaudit/mcp-server

  1. Configure your MCP client (see below for specific instructions)

  2. Authenticate - On first use, a browser window will open for you to log in to your Reaudit account

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

Cursor

Add the following to your Cursor MCP settings:

macOS: ~/.cursor/mcp.json Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

Other MCP Clients

Use these settings:

  • Command: npx
  • Arguments: ["@reaudit/mcp-server"]
  • Environment: REAUDIT_BASE_URL=https://reaudit.io

Authentication

The first time you use the MCP server, it will:

  1. Open your default browser to the Reaudit login page
  2. Ask you to authorize the MCP server to access your account
  3. Store the authentication tokens securely on your machine

Tokens are stored in ~/.reaudit/credentials.json and are automatically refreshed when needed.

Revoking Access

You can revoke the MCP server's access at any time:

  1. Go to Reaudit Settings
  2. Find "Connected Apps"
  3. Click "Revoke" next to "Reaudit MCP Server"

Available Tools (80 total)

Project Tools

ToolDescription
list_projectsList all projects in your Reaudit account
set_active_projectSet the active project context for subsequent commands
get_active_projectGet the currently active project

Project Settings Tools

ToolDescription
get_project_settingsGet all settings for a project including brand info, writing style, social media, competitors, author card, and more
update_project_settingsUpdate project settings including brand name, description, writing style, social media links, competitors, author card, industry, language, and more

Account Tools

ToolDescription
get_usage_summaryGet your current usage vs limits for prompts, content, images, and audits

AI Visibility Tools

ToolDescription
get_visibility_scoreGet the AI visibility score for a project with metrics breakdown
get_brand_mentionsGet recent brand mentions across AI platforms (ChatGPT, Claude, Perplexity, etc.)
get_competitor_comparisonCompare your AI visibility with competitors

SEO Audit Tools

ToolDescription
list_auditsList SEO audits with status and scores
get_audit_detailsGet detailed audit results including scores, recommendations, and technical issues
get_audit_recommendationsGet prioritized SEO recommendations grouped by impact level

Content Tools

ToolDescription
search_knowledge_baseSearch your project knowledge base for relevant content
get_content_suggestionsGet AI-generated content suggestions based on SEO analysis

Content Generation Tools

ToolDescription
generate_contentGenerate AI-powered content (blog posts, social media, newsletters, video scripts, etc.) using project knowledge base for context
get_content_historyGet your content generation history, filterable by project or content type
get_content_detailsGet full details of a generated content piece including complete content and SEO data

Analytics Tools

ToolDescription
get_citation_analyticsGet citation trends, top cited domains, and platform breakdown
get_wordpress_analyticsGet WordPress AI bot tracking data showing which crawlers visit your site

Analytics Query Tools

ToolDescription
query_analyticsExecute a flexible analytics query with custom metrics, dimensions, filters, and time grains for building custom reports

Usage & Budget Tools

ToolDescription
get_token_usageGet a summary of your LLM token usage and costs
get_budget_statusGet your current budget limits and usage status
set_budget_limitsSet monthly budget limits for token usage and costs

Calendar Tools

ToolDescription
get_content_calendarGet your content calendar showing scheduled, planned, and published content across all platforms

Strategy Tools

ToolDescription
list_strategiesList all GTM (Go-To-Market) strategies, filterable by project or status
get_strategy_detailsGet detailed information about a strategy including module progress and outputs
create_strategyCreate a new GTM strategy session with business context
get_strategy_content_itemsGet content items from a strategy's 90-day content calendar
update_content_item_statusUpdate a content item's status, notes, topic, platform, or planned date

Strategy Step Runner Tools

Run GTM strategies step-by-step through the AI assistant. Each step uses Perplexity deep search and builds on previous outputs progressively.

ToolDescription
generate_strategy_stepGenerate AI content for a specific module step. Supports additional context for guided regeneration. Costs credits per generation.
get_strategy_step_outputRead the full generated output of any step, including content, citations, and edit history
edit_strategy_stepEdit/refine the content of a completed step. Edits are saved separately from the original AI output.
get_strategy_step_mapGet a reference map of all 6 modules (21 steps), dependencies, and recommended workflow

Modules: 1=Research (3 steps), 2=Strategy (3), 3=Content Strategy (3), 4=Funnel (4), 5=Execution (3), 6=Offer (5)

Sources & Outreach Tools

ToolDescription
get_citation_sourcesGet citation sources showing which URLs are cited by AI models and their frequency
extract_author_infoExtract author information from a URL (name, email, bio, social links) for outreach
list_outreach_opportunitiesList outreach opportunities for link building or content collaboration
create_outreach_opportunityCreate a new outreach opportunity to track potential contacts

Indexing Tools

ToolDescription
list_indexing_connectionsList website indexing connections (IndexNow and Google Search Console)
create_indexing_connectionCreate a new indexing connection for sitemap monitoring and instant indexing
sync_indexing_connectionTrigger a sitemap sync to submit new/updated URLs to search engines

Social Media Tools

ToolDescription
list_social_connectionsList connected social media accounts (X/Twitter, LinkedIn) with publishing stats
list_social_postsList social media posts filtered by platform, status, or project
generate_social_postsGenerate social media posts from existing content for X/Twitter and LinkedIn
publish_social_postPublish a draft social media post immediately
schedule_social_postSchedule a social media post for later publication

Publishing Tools

ToolDescription
list_wordpress_connectionsList connected WordPress sites for publishing
publish_to_wordpressPublish content to WordPress with schema markup for AI search visibility
list_react_connectionsList React/webhook connections for headless CMS publishing
publish_to_reactPublish content via webhook to a React/Next.js site

Optimization Tools

ToolDescription
generate_llms_txtGenerate an AI-optimized llms.txt file to help AI assistants understand your business
translate_contentTranslate generated content to another language, creating a new content entry

Prompt Tracking Tools

ToolDescription
list_prompt_topicsList prompt topics for tracking brand visibility in AI responses
create_prompt_topicCreate a new prompt topic with initial prompts for organized tracking
add_prompts_to_topicAdd new prompts to an existing topic
track_promptSubmit a prompt for AI tracking across ChatGPT, Perplexity, and Google
get_prompt_analyticsGet analytics for tracked prompts including mentions, sentiment, and visibility rates
generate_prompt_suggestionsUse AI to generate prompt suggestions based on your project context

Saved Reports Tools

ToolDescription
list_reportsList saved analytics reports with reusable query configurations
create_reportCreate a saved report with custom metrics, dimensions, filters, and visualizations
get_reportGet details of a saved analytics report
delete_reportDelete a saved analytics report

Action Grid Tools

ToolDescription
list_action_gridsList optimization task boards for a project
create_action_gridCreate a task board with categorized items for SEO, content, or any workflow
get_action_gridGet an action grid with all items grouped by category with progress tracking
delete_action_gridDelete an action grid
add_grid_itemsAdd new items to an existing action grid
update_grid_itemUpdate status, priority, assignee, or notes of an action grid item

AI Bot Crawl Analytics

ToolDescription
get_agent_analyticsGet AI bot crawl analytics: which bots (GPTBot, ClaudeBot, PerplexityBot) visit your site, top crawled pages, cited domains, and content topics

Site Tracking Tools

Track AI referral performance and bot crawl activity across WordPress, Webflow, and Wix sites.

ToolDescription
get_ai_referral_performanceGet AI referral performance for WordPress articles — which articles get traffic from ChatGPT, Perplexity, etc.
get_page_citationsGet page citations — which pages are crawled by LLM bots, how often, and by which bots
get_webflow_trackingGet Webflow site bot tracking analytics with bot type breakdown and top crawled pages
get_wix_trackingGet Wix site bot tracking analytics with bot type breakdown and top crawled pages

Competitor Management Tools

ToolDescription
list_competitorsList tracked competitors with filtering by category, search, and pagination
add_competitorAdd a new competitor to track (name, URL, category, industry, tags)
delete_competitorDelete (deactivate) a tracked competitor by ID

Reddit Lead Monitoring Tools

ToolDescription
list_reddit_monitorsList monitored subreddits for a project with keywords, stats, and activity
get_reddit_leadsGet Reddit leads identified from monitored subreddits, filter by status and score
update_reddit_leadUpdate a Reddit lead status (new, contacted, qualified, converted, dismissed)

GA4 Analytics Tools

ToolDescription
get_ga4_analyticsGet Google Analytics 4 data: traffic overview, sources, top pages, timeseries, and AI referral traffic

SEO Alert Tools

ToolDescription
get_seo_alertsGet SEO alerts — visibility drops, crawl issues, ranking changes, or aggregated summary

Available Prompts (5 templates)

Pre-built prompt templates for common workflows:

PromptDescription
weekly_visibility_reportGenerate a weekly AI visibility report with analysis
seo_action_planCreate an actionable SEO improvement plan from audit results
content_strategyDevelop a content strategy based on knowledge base and SEO data
competitor_analysisAnalyze competitor visibility with strategic recommendations
bot_activity_summarySummarize AI bot crawling activity with insights

Available Resources

Read-only data accessible via reaudit:// URIs:

URIDescription
reaudit://projectsList of all your projects
reaudit://accountAccount details and usage summary
reaudit://projects/{id}/visibilityVisibility metrics for a project
reaudit://projects/{id}/mentionsBrand mentions for a project
reaudit://audits/{id}Detailed audit results

Example Conversations

Set active project and check visibility

You: List my projects and set the main one as active

Assistant: Found 3 projects. Setting "My Brand" as active.

You: What's my visibility score?

Assistant: Your AI Visibility Score is 72/100.

  • Total Mentions: 45 in the last 30 days
  • Citation Rate: 38%
  • Average Sentiment: 78/100

Get SEO recommendations

You: What are the critical SEO issues I need to fix?

Assistant: Here are the critical recommendations from your latest audit:

  1. Missing meta descriptions (Technical) Impact: High | Effort: Quick

  2. Slow page load time (Performance) Impact: Critical | Effort: Moderate

Generate content and publish to WordPress

You: Generate a blog post about AI visibility best practices, then publish it to my WordPress site

Assistant: I'll generate the content using your knowledge base for context, then publish it.

[Generates content with schema markup, internal linking, and SEO optimization]

Content published to WordPress! Post URL: https://yourblog.com/ai-visibility-best-practices

Track prompts for brand visibility

You: Create a prompt topic for "product comparison" and add some prompts to track

Assistant: Created topic "Product Comparison" with 3 prompts. I can now track these across ChatGPT, Perplexity, and Google to see how your brand is mentioned.

You: Show me the analytics for my tracked prompts

Assistant: Over the last 30 days:

  • 42 prompts tracked across 3 platforms
  • Brand mentioned in 68% of responses
  • Average sentiment: 82/100
  • Best performing platform: Perplexity (78% mention rate)

Create a social media campaign

You: Generate social media posts from my latest blog article

Assistant: Generated 4 draft posts:

  • 2 for X/Twitter (short-form with hashtags)
  • 2 for LinkedIn (professional long-form)

You: Publish the first Twitter post and schedule the LinkedIn one for tomorrow

Assistant: Done! Twitter post published. LinkedIn post scheduled for tomorrow at 9:00 AM.

Build a custom analytics report

You: Create a weekly visibility report showing mentions and sentiment by platform

Assistant: Created saved report "Weekly Visibility by Platform" with:

  • Metrics: mentions, sentiment
  • Dimensions: platform, week
  • Visualization: line chart

You can run this report anytime with get_report.

Read and update project settings

You: Show me my project settings

Assistant: Here are your project settings for "My Brand":

  • Brand Name: My Brand
  • Main Keyword: AI visibility
  • Alternative Keywords: SEO automation, brand monitoring
  • Industry: SaaS
  • Language: English

You: Update my brand description to "We help businesses track their AI visibility" and add "AI ranking" as an alternative keyword

Assistant: Project settings updated successfully! Updated fields: settings.brandDescription, settings.alternativeKeywords

Run a GTM strategy step-by-step

You: Show me the GTM strategy step map

Assistant: Here are the 6 modules and 21 steps:

  • Module 1: Research Layer (ICP Deep Dive, Competitive Intelligence, Market Trends)
  • Module 2: Strategy Layer (Positioning, GTM Motion, Messaging)
  • ...

You: Generate the ICP Deep Dive for strategy abc123, focus on enterprise customers

Assistant: Generated! Module 1 > ICP Deep Dive is complete. Here's the content... Next step: Competitive Intelligence (module 1, step 2).

You: That looks good. Now generate the next step.

Assistant: Generated! Module 1 > Competitive Intelligence is complete with 8 citations...

You: Edit the ICP Deep Dive to add a section about mid-market companies

Assistant: Step content updated. Use get_strategy_step_output to view the full content.

Search your knowledge base

You: What do we say about pricing on our website?

Assistant: Found 3 relevant sections about pricing from your knowledge base...

Troubleshooting

"Failed to spawn process: No such file or directory"

This is the most common setup issue. It has two possible causes:

1. Node.js is not installed. The Reaudit MCP server requires Node.js 18+. Check by running node --version in your terminal.

2. Node.js is installed but not in your MCP client's PATH. Apps like Claude Desktop and Cursor use a restricted system PATH that may not include the directory where Node.js is installed. Fix this by using the full absolute path to npx:

  1. Run which npx in your terminal to get the full path
  2. Replace "command": "npx" with the full path in your config, e.g. "command": "/usr/local/bin/npx"
  3. Fully restart your MCP client (on macOS, quit from the menu bar — don't just close the window)

Common npx paths: /usr/local/bin/npx (default), /opt/homebrew/bin/npx (Homebrew on macOS), ~/.nvm/versions/node/vX.X.X/bin/npx (nvm)

"Authentication required" error

The MCP server needs to authenticate with your Reaudit account. Make sure:

  1. You have an active Reaudit subscription
  2. A browser window opened for authentication
  3. You completed the login process

"Token expired" error

Your authentication token has expired. The server will automatically try to refresh it. If that fails:

  1. Delete ~/.reaudit/credentials.json
  2. Restart your MCP client
  3. Complete the authentication flow again

Browser doesn't open

If the browser doesn't open automatically, check the terminal output for a URL you can copy and paste.

Connection errors

Make sure you can reach https://reaudit.io from your network.

Environment Variables

VariableDefaultDescription
REAUDIT_BASE_URLhttps://reaudit.ioReaudit API base URL

Security

  • OAuth 2.0 with PKCE for secure authentication
  • Tokens stored locally with encryption
  • Refresh tokens automatically rotated
  • You can revoke access at any time from Reaudit settings

Support

License

Proprietary - see LICENSE for details.

Related Servers