<!--
Source: https://swappr.fr
Canonical: https://swappr.fr/llm/mcp.md
Last-updated: 2026-06-17
-->

# Swappr — Claude Skill et MCP

## Claude Skill

Fichier : `skills/swappr-api/SKILL.md`

Permet à Claude (Code, Desktop, API) d'utiliser l'API Swappr avec une simple variable d'environnement :

```bash
export SWAPPR_API_KEY="sk_swp_..."
```

Capacités exposées :
- Lancer une génération image (image safe ou NSFW selon le plan)
- Poll le statut d'un job
- Lister la bibliothèque
- Vérifier les crédits et le plan

## Serveur MCP standalone

Package : **`@swappr/mcp@0.3.0`** sur npm (publié — `npx -y @swappr/mcp`)

Compatible Claude Desktop, Continue, Cline et tout client MCP-compliant.

Configuration Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`) :

```json
{
  "mcpServers": {
    "swappr": {
      "command": "npx",
      "args": ["-y", "@swappr/mcp"],
      "env": {
        "SWAPPR_API_KEY": "sk_swp_..."
      }
    }
  }
}
```

## 5 tools MCP exposés

| Tool | Description |
|---|---|
| swappr_me | Profil + crédits + abonnement |
| swappr_credits_balance | Solde crédits |
| swappr_generate_image | Lance une génération image (async, retourne jobId) |
| swappr_job_status | Statut + outputs d'un job |
| swappr_list_library | Bibliothèque (kind, limit, cursor) |

## Usage type dans Claude

> "Génère 4 visuels Instagram cinématiques pour un café à Lyon en heure dorée, format 4:5, modèle Seedream"

Claude appelle `swappr_generate_image` 4 fois, poll les jobs, retourne les URLs. ~30s.

## Documentation

API REST : https://swappr.fr/api-docs
OpenAPI : https://swappr.fr/openapi.yaml