Metadata-Version: 2.5
Name: rayonne-mcp
Version: 0.3.1
Summary: Rayonne MCP server — pilote le workspace Rayonne (audit marketing, analyse produit, contenus, vidéos, métriques AARRR) depuis tout agent compatible MCP.
Author-email: Sponge Theory <contact@sponge-theory.ai>
License: SPONGE THEORY PROPRIETARY LICENSE
Keywords: claude,marketing,mcp,rayonne,sponge-theory
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: mcp[cli]<2,>=1.2.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# Rayonne MCP

Serveur MCP (stdio) exposant le workspace Rayonne — contenus, soumissions,
métriques AARRR — à tout agent compatible MCP (Claude Code, Claude Desktop…),
via l'**API publique v1 en lecture** (`docs/API.md` du repo).

## Prérequis

Une clé API workspace (`rk_…`) : Rayonne → **Réglages → Clés API**
(plan **Business**, entitlement `api_access`).

## Claude Code

```sh
claude mcp add rayonne \
  --env RAYONNE_API_KEY=rk_xxxxxxxx \
  --env RAYONNE_API_URL=https://rayonne.sponge-theory.dev \
  -- uv run --project /chemin/vers/rayonne/mcp rayonne-mcp
```

## Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "rayonne": {
      "command": "uv",
      "args": ["run", "--project", "/chemin/vers/rayonne/mcp", "rayonne-mcp"],
      "env": {
        "RAYONNE_API_KEY": "rk_xxxxxxxx",
        "RAYONNE_API_URL": "https://rayonne.sponge-theory.dev"
      }
    }
  }
}
```

Le serveur démarre **sans** clé (non fatal) : chaque outil renvoie alors un
message d'installation clair au lieu d'un crash.

## Outils

| Outil | Rend |
|---|---|
| `rayonne_overview` | nom, URL produit, autopilote, compteurs contenus/soumissions par statut |
| `rayonne_list_content` | derniers contenus (+ `predicted_engagement` 0-100) |
| `rayonne_list_submissions` | statut de publication par plateforme (+ `external_url`) |
| `rayonne_metrics_aarrr` | snapshot AARRR (stages, geo, by_channel, timeseries, deltas) |

## Tests

```sh
cd mcp && uv run --extra dev pytest -q
```

## Publication marketplace

À faire via le flux commun Sponge Theory (même patron qu'`audigeo-mcp` :
stdio + PyPI, vendored dans `ezeeFlop/claude-plugins`) — voir l'agent
`mcp-plugin-publisher`.
