# MCP

A Model Context Protocol (MCP) server for DagenoAI.

## Installation

### Claude Code

```bash
claude mcp add --transport http dageno https://api.dageno.ai/mcp \
  --header "x-api-key: your-token"
```

### Cursor

```json
{
  "mcpServers": {
    "dageno": {
      "type": "sse",
      "url": "https://api.dageno.ai/mcp",
      "headers": {
        "x-api-key": "your-token"
      }
    }
  }
}
```

## Tool Reference

| Tool | Purpose | Common Use Cases |
| --- | --- | --- |
| `get_brand_info` | Get core brand information for the current project (name, domain, summary, keywords, competitors, etc.). | Build a brand profile and use it as context for downstream analysis. |
| `get_geo_analysis` | Run GEO DSL analysis (for example visibility ranking, matrix analysis, trend analysis). | Check key metrics such as visibility and citation performance. |
| `get_keyword_volume` | Get search volume data for a list of keywords. (Each keyword consumes 1 credit.) | Estimate search demand and prioritize keywords for content planning. |
| `get_seo_traffic` | Get DataHouse SEO traffic aggregate data by domain. (Each request consumes 1 credit.) | Check site traffic profile, top keywords, and basic whois timestamps. |
| `get_topics` | Get a topic list by time range and filters (with pagination). | Review core project topics and their performance. |
| `get_prompts` | Get a prompt list by time range (with pagination, sorting, and filters). | Identify high-performing prompts and coverage gaps. |
| `batch_create_prompts` | Batch create prompts and return latest prompt data list. | Batch add new prompts for planned GEO experiments. |
| `batch_delete_prompts` | Batch delete prompts by IDs. | Remove invalid or obsolete prompts. |
| `batch_update_prompts` | Batch update prompts and return latest prompt data. | Toggle status, edit text, switch topic, or adjust regions. |
| `batch_get_prompt_by_ids` | Batch get prompt details by IDs. | Inspect specific prompts before update/analysis. |
| `get_citation_domains` | Get aggregated cited domains (with pagination and filters). | See which domains cite your project most often. |
| `get_citation_urls` | Get cited URL list (with pagination and filters). | Locate specific cited pages for detailed review. |
| `get_prompt_citation_domains` | Get aggregated cited domains for a specific prompt. | Compare citation domain distribution for one prompt. |
| `get_prompt_citation_urls` | Get cited URL list for a specific prompt. | Analyze concrete cited pages for one prompt. |
| `get_prompt_query_fanout` | Get query fanout list for a specific prompt. | Understand query expansion patterns and related user intents per prompt. |
| `get_content_opportunities` | Get content opportunity list (with pagination and filters). | Discover what content should be created or improved first. |
| `get_backlink_opportunities` | Get backlink opportunity list. | Find high-priority backlink targets and opportunities. |
| `get_community_opportunities` | Get social/community opportunity list. | Identify topics with high potential for community distribution. |

## Example Queries

Below are natural-language prompts you can use directly in MCP-enabled clients.

### Brand Basics

```text
Please analyze the brand basics of the current project and summarize positioning, core keywords, and main competitors.
```

### Visibility Analysis

```text
Please evaluate the current project's visibility performance over the past month, and provide key findings and trend insights.
```

### Content Opportunities

```text
What content opportunities are available for the current project? Please rank the top three by priority and explain why.
```

### Topics and Prompts

```text
Please identify the best-performing topics in the past month and the high-performing prompts associated with them, then provide a short summary.
```

### Citation Source Analysis

```text
Please analyze the most frequently cited domains and page URLs over the past month, and summarize the key source patterns.
```

### Deep Dive on a Single Prompt

```text
I will provide a prompt ID. Please analyze its citation distribution and high-value citation sources.
```

### SEO Traffic

```text
Please fetch SEO traffic data for www.example.com and summarize visits, ranking, month-over-month trend, and top keywords.
```

### Backlink Opportunities

```text
Please list the top five backlink opportunities worth prioritizing in the past month, and explain your reasoning.
```

### Social/Community Opportunities

```text
Please rank the top five social/community opportunities for the current project by potential impact.
```