npm package: @seoxai/mcp-server
Description: SEOxAI MCP Server – AI SEO agency services, pricing, and blog access for Claude, ChatGPT, Gemini and any MCP-compatible client. | AI SEO ügynökség szolgáltatások, árazás, blogcikkek elérése.
Latest version: 2.0.6

# SEOxAI MCP Server

> Connect [SEOxAI](https://seoxai.hu) services, pricing, and blog content to Claude, ChatGPT, GitHub Copilot, Cursor, and any MCP-compatible AI client.

**SEOxAI** is Hungary's leading AI SEO & Digital Transformation agency. This MCP server gives AI assistants real-time access to our services, pricing, 100+ blog articles, and personalized recommendations.

## Installation

No install needed — the server runs in the cloud. Just connect your AI client.

### Claude Desktop (one command, requires Node.js)

```bash
npx -y @seoxai/mcp-server --install
```

Then restart Claude Desktop. Done.

To uninstall: `npx -y @seoxai/mcp-server --uninstall`

### Claude Desktop (manual — no install needed)

Add to your `claude_desktop_config.json`:

| OS | Config path |
|---|---|
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |

```json
{
  "mcpServers": {
    "seoxai": {
      "url": "https://seoxai-mcp-476125043667.europe-west1.run.app/mcp"
    }
  }
}
```

### Claude Code

```bash
claude mcp add --transport http seoxai https://seoxai-mcp-476125043667.europe-west1.run.app/mcp
```

### VS Code / GitHub Copilot

Command Palette → `MCP: Add Server` → `HTTP` → URL: `https://seoxai-mcp-476125043667.europe-west1.run.app/mcp`

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "seoxai": {
      "url": "https://seoxai-mcp-476125043667.europe-west1.run.app/mcp"
    }
  }
}
```

### Any MCP-compatible client

Use this remote URL:

```
https://seoxai-mcp-476125043667.europe-west1.run.app/mcp
```

## What's Inside

### Tools (AI can call these)

| Tool | Description |
|---|---|
| `search_blog` | Search 100+ SEO/AI blog articles with fuzzy matching |
| `get_pricing` | Get service pricing — filter by service or get all |
| `get_recommendation` | Personalized service recommendation based on business type, goals, and budget |

### Resources (AI can read these)

| URI | Description |
|---|---|
| `seoxai://services` | All services with full pricing |
| `seoxai://services/{slug}` | Single service details |
| `seoxai://blog` | Latest 50 blog articles |
| `seoxai://blog/{slug}` | Full article content (Markdown) |
| `seoxai://contact` | Contact info, consultation booking |
| `seoxai://about` | Agency profile, tech stack, USP |

### Prompts (Pre-built templates)

| Prompt | Description |
|---|---|
| `seo_audit` | SEO & AEO analysis for any website |
| `service_comparison` | Compare SEOxAI packages side by side |
| `blog_summary` | Summarize latest or topic-specific articles |
| `ai_consultation` | Prepare a structured AI consultation brief |
| `competitive_analysis` | Compare your site against a competitor |

## Services Covered

| Service | Packages |
|---|---|
| **AI SEO / AEO** | Technical Base, Maintenance, Growth, Dominance |
| **AI Chatbot Development** | AI Start, AI Business, AI Enterprise |
| **AI Automation** | Pilot Workflow, AI Partner Program |
| **Enterprise Knowledge Base (RAG)** | Knowledge Vault Setup, Brain Keeper |
| **AI Readiness Audit** | Free Quick Test, Deep Dive Audit |
| **Premium Web Development** | Starter, Professional, Enterprise, Custom Configurator |

## Bilingual Support

All data is available in **Hungarian** (default) and **English**. Every tool and prompt accepts a `language` parameter (`"hu"` or `"en"`).

## Tech Stack

- TypeScript (ESM) on Node.js >= 20
- MCP SDK `@modelcontextprotocol/sdk` ^1.26.0
- TF-IDF + Levenshtein fuzzy search for blog
- stdio transport (default) + Streamable HTTP (`--http`)

## Development

```bash
git clone https://github.com/seoxai/mcp-server.git
cd mcp-server
npm install
npm run build
npm test          # 42 tests
npm run inspect   # MCP Inspector
```

For maintainers and AI assistants: see [MAINTENANCE.md](./MAINTENANCE.md) for detailed architecture, data schema, and how to add/update services.

## Contact

- **Web:** [seoxai.hu](https://seoxai.hu)
- **Email:** info@seoxai.hu
- **Phone:** +36 30 094 4758
- **Free consultation:** [seoxai.hu/ai-audit](https://seoxai.hu/ai-audit)

## License

MIT