npm package: @naridon/mcp-server
Description: MCP server exposing Naridon AI visibility data to AI assistants
Latest version: 0.4.0

# @naridon/mcp-server

MCP server for [Naridon](https://naridon.com) — manage your AI visibility, optimization, CMS, and content from any MCP-compatible AI assistant.

## Quick Setup

### Claude Code

Add to your project's `.mcp.json` or `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "naridon": {
      "command": "npx",
      "args": ["-y", "@naridon/mcp-server"],
      "env": {
        "NARIDON_API_KEY": "nrdn_your_api_key_here"
      }
    }
  }
}
```

### Cursor / Windsurf

Add to your MCP config:

```json
{
  "naridon": {
    "command": "npx",
    "args": ["-y", "@naridon/mcp-server"],
    "env": {
      "NARIDON_API_KEY": "nrdn_your_api_key_here"
    }
  }
}
```

## Getting your API Key

1. Log in to [Naridon](https://app.naridon.com)
2. Go to **Settings** > **API Keys**
3. Click **Generate API Key**
4. Copy the key (starts with `nrdn_`)

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `NARIDON_API_KEY` | Yes | Your per-shop API key |
| `NARIDON_API_URL` | No | API base URL (default: `https://app.naridon.com/api/v1`) |

For staging, set:
```
NARIDON_API_URL=https://api-staging.naridon.com/api/v1
```

## Available Tools

### Monitoring
- `get_dashboard` — Full monitoring dashboard overview
- `get_prompt_rankings` — Visibility rankings for tracked prompts
- `get_sentiment` — Sentiment analysis data
- `get_citations` — Citation data for your brand
- `get_mentions` — Social mentions and brand references
- `get_platforms` — Platform visibility rankings
- `get_content_gaps` — Content gap analysis
- `get_competitors` — Competitor analysis
- `discover_prompts` — Discover new prompts to track
- `calculate_aeo_score` — Optimization readiness score

### Optimization
- `get_store_stats` — Optimization statistics
- `get_fix_suggestions` — Pending fix suggestions
- `apply_fix` — Apply a fix to the store
- `approve_fix` — Approve a drafted fix
- `revert_fix` — Revert an applied fix
- `trigger_scan` — Trigger an optimization scan

### Content AI
- `generate_content` — Generate optimized content
- `list_content` — List generated content
- `get_content` — Get content details
- `publish_content` — Publish content to your platform

### CMS
- `cms_create_page` — Create a page or blog post
- `cms_update_page` — Update a page
- `cms_publish_page` — Publish a page
- `cms_list_pages` — List all pages
- `cms_list_media` — List uploaded media
- `cms_export` — Export all pages as JSON

### Other
- `get_settings` / `update_settings` — Shop settings
- `get_credit_balance` / `get_credit_usage` — Credit balance
- `send_chat_message` — AI assistant chat
- `get_brand_voice` / `update_brand_voice` — Brand voice
- `list_reports` / `generate_report` — Reports

## Example Usage

Once connected, ask your AI assistant:

- "What's my current visibility score?"
- "Show me pending optimization fixes"
- "Create a blog post about our new product launch"
- "What content gaps do I have compared to competitors?"
- "Generate a product description optimized for AI search"
- "Export all my CMS pages"

## License

MIT