<!-- mcp-name: io.github.crypto-yannso/viraill-mcp -->
# Viraill MCP Server

Model Context Protocol (MCP) server for **Viraill** — Generative Engine Optimization (GEO) & Agentic Commerce Readiness.

This server enables Claude Desktop, Cursor, Windsurf, Hermes, and any MCP client to diagnose AI search engine visibility, generate intent-aligned social content, and audit Agentic Commerce Readiness.

---

## Tools Exposed

1. **`geo_audit`**
   - Audits visibility across ChatGPT, Perplexity, Gemini, and Claude.
   - Computes intent gaps against market query centroids.
   - Generates RAG Answer Blocks (BLUF) and Schema.org markup.
2. **`geo_social_generate`**
   - Generates LinkedIn, X/Threads, Debate, and Carousel content.
   - Calibrates posts against market intention centroids.
3. **`agentic_scan`**
   - Scores site Agentic Readiness (/100) across 5 pillars.
   - Generates complete remediation files (`llms.txt`, `agent.json`, `openapi.json`).

---

## Installation & Configuration

### 1. Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "viraill": {
      "command": "npx",
      "args": ["-y", "@crypto-yannso/viraill-mcp"]
    }
  }
}
```

### 2. Cursor IDE (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "viraill": {
      "command": "npx",
      "args": ["-y", "@crypto-yannso/viraill-mcp"]
    }
  }
}
```

### 3. Smithery (Claude & Cursor 1-Click)

```bash
npx -y @smithery/cli install @crypto-yannso/viraill-mcp --client claude
```

---

## Environment Variables (Optional)

- `VIRAILL_API_KEY` : Optional API key for enterprise quotas. Free tier (1 call/day/IP) works out of the box without any key.
- `X_PAYMENT` : Optional x402 payment header (Base USDC micropayments).

## License

MIT © [ARTAIFACT](https://artaifact.online) & [Viraill](https://viraill.com)