ClayHog MCP Server

MCP server that connects AI assistants (Claude Desktop, Cursor, Windsurf, etc.) to your ClayHog account. Ask natural-language questions about brand visibility across AI platforms, create content, research topics, and manage your monitoring setup.

Requires Node.js 18+.

Installation

# Global install
npm install -g clayhog-mcp

# Or run directly with npx (no install needed)
npx clayhog-mcp

Authentication

You need a ClayHog personal access token and your tenant ID. Generate a token in Settings > Access Tokens in the ClayHog app.

There are two ways to authenticate:

Option 1: Environment variables (recommended)

Set credentials in the MCP client config. The server auto-connects on startup. This is the safer option because tokens are never passed through tool arguments.

Option 2: Interactive connect tool

Start the server without credentials and call the connect tool in your conversation to provide them. Note that MCP hosts may log tool arguments, so the token could appear in client-side logs.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "clayhog": {
      "command": "npx",
      "args": ["-y", "clayhog-mcp"],
      "env": {
        "CLAYHOG_API_URL": "https://api.clayhog.com",
        "CLAYHOG_API_TOKEN": "your-token",
        "CLAYHOG_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or global settings:

{
  "mcpServers": {
    "clayhog": {
      "command": "npx",
      "args": ["-y", "clayhog-mcp"],
      "env": {
        "CLAYHOG_API_URL": "https://api.clayhog.com",
        "CLAYHOG_API_TOKEN": "your-token",
        "CLAYHOG_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Environment variables

| Variable | Description | |----------|-------------| | CLAYHOG_API_URL | ClayHog backend URL (e.g. https://api.clayhog.com) | | CLAYHOG_API_TOKEN | Personal access token from Settings > Access Tokens | | CLAYHOG_TENANT_ID | Your tenant ID |

All three are optional if you plan to use the interactive connect tool instead.

Available Tools

Connection

| Tool | Description | |------|-------------| | connect | Connect to ClayHog with API URL, token, and tenant ID | | status | Check connection status | | get_current_user | Get authenticated user profile | | get_notifications | Get recent notifications |

Brand Visibility

| Tool | Description | |------|-------------| | list_brands | List all brands (start here to get brand IDs) | | get_brand | Get brand details | | create_brand | Create a new brand to monitor | | update_brand | Update brand name, URL, description, brand book, or keywords | | get_brand_analytics | Visibility analytics with date range and model filters | | get_competitive_analysis | Competitive ranking overview across AI platforms | | get_competitor_detail | Deep dive into one competitor | | get_competitor_comparison | Side-by-side brand vs competitor metrics | | get_suggested_competitors | AI-suggested competitors for a brand | | get_suggested_prompts | AI-suggested tracking prompts | | get_suggested_brandbook | AI-suggested brand book entries |

Watches (Scouts)

| Tool | Description | |------|-------------| | list_watches | List monitoring scouts for a brand | | get_watch | Get scout details and schedule | | get_watch_analytics | Scout-level visibility analytics | | get_watch_citation_domains | Domains cited in scout responses | | create_watch | Create a new monitoring scout | | update_watch | Update scout settings | | delete_watch | Delete a scout | | toggle_watch_active | Pause or resume a scout |

Prompts

| Tool | Description | |------|-------------| | list_prompts | List tracked prompts | | get_prompt | Get prompt with response history | | get_source_keywords | Source keywords for prompt generation | | create_prompts | Create new tracking prompts | | generate_prompts_from_keywords | Auto-generate prompts from keywords | | toggle_prompt_active | Enable or disable a prompt |

Topic Research

| Tool | Description | |------|-------------| | run_topic_research | Research related topics and search suggestions | | get_topic_research_prompts | Get AI-generated prompts for a topic | | get_topic_research_brands_sources | Brands and sources dominating a topic | | get_topic_research_paa | People Also Ask questions for a topic | | run_serp_analysis | SERP competitive landscape for a keyword | | list_topic_researches | List saved research results | | get_topic_research | Get a saved research result |

Responses and Citations

| Tool | Description | |------|-------------| | list_responses | List AI model responses | | get_response | Full response with citations and competitors | | list_citations | List all citations | | get_citation_domains | Citations grouped by domain |

Competitors

| Tool | Description | |------|-------------| | list_competitors | List tracked competitors | | add_competitors | Add competitors to track | | update_competitor | Update competitor details |

Content

| Tool | Description | |------|-------------| | list_contents | Content library | | get_content | Content details with GEO analysis | | get_content_ideas | AI-generated content ideas | | get_cited_pages | Brand pages cited by AI models | | get_reddit_discussions | Relevant Reddit discussions | | suggest_reddit_reply | Generate a reply for a Reddit thread | | generate_outline | Generate content outline from a prompt | | create_content | Create content (from prompt, outline, or scratch) | | update_content | Update content body and metadata | | delete_content | Delete content | | optimize_content | Auto-optimize content for AI visibility (GEO) | | accept_optimization | Accept pending optimization | | discard_optimization | Discard pending optimization | | analyze_content_geo | Run GEO analysis | | analyze_content_signals | Analyze SEO and GEO signals | | inline_edit_content | AI-assisted section editing | | translate_content | Translate content to another language | | restructure_content | Restructure around a new outline | | push_content_to_source | Push content to connected CMS |

Domain Authority

| Tool | Description | |------|-------------| | list_domain_authorities | List tracked domains with authority scores | | get_domain_authority | Detailed domain authority data | | get_domain_authority_usage | Lookup usage stats | | lookup_domain_authority | Look up a new domain | | get_domain_backlinks | Backlink data for a domain | | get_domain_referring_domains | Referring domains | | get_domain_ai_visibility | AI visibility metrics | | get_domain_citation_quality | Citation quality analysis | | get_domain_keywords | Keyword rankings |

Workflow Templates (MCP Prompts)

Pre-built workflow templates available in Claude Desktop's prompt picker:

| Template | Description | |----------|-------------| | Weekly Visibility Report | Generates a weekly brand report with analytics, competitive standings, and citation sources | | Content Pipeline | Full content creation flow: pick a prompt, outline, create, and GEO analyze | | Competitive Snapshot | Competitive analysis across all AI platforms with per-competitor breakdowns | | Topic Research | Research a topic for content opportunities, PAA questions, and competitive gaps | | Set Up a New Brand | Full onboarding: create a brand, add competitors, generate prompts, and start a scout |

MCP Resources

| Resource | Description | |----------|-------------| | clayhog://help | Concepts, AI model types, date format, and workflow guides | | clayhog://connection | Current connection status |

Troubleshooting

| Error | Cause | Fix | |-------|-------|-----| | "Authentication failed" | Invalid or expired API token | Generate a new token in Settings > Access Tokens and reconnect | | "Access denied" | Token lacks required permissions | Generate a new token with full access | | "This feature requires a plan upgrade" | Feature not available on your current plan | Upgrade your plan in ClayHog billing settings | | "Not found" | Wrong ID or resource does not exist | Verify the brand/watch/prompt ID using the relevant list tool | | "Validation failed" | Invalid request parameters | Check the error details for which fields need fixing | | "Rate limited" | Too many requests | Wait a moment and try again | | "Request timed out" | API is slow or unreachable | Check your API URL and server status | | "Network error" | Cannot reach the API | Verify CLAYHOG_API_URL is correct and the server is running | | "Not connected" | No credentials provided | Call connect or set environment variables |

Development

npm install        # Install dependencies
npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm run lint       # ESLint
npm run prettier   # Format code
npm start          # Run the server

Testing locally

Use the MCP Inspector to test tools interactively:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT