MCP Server

Ajoutez l402-kit comme outil MCP pour que Claude Desktop, Cursor et tout agent IA compatible MCP puissent payer des API Lightning automatiquement.

Qu’est-ce que MCP ?

Model Context Protocol est le standard ouvert d’Anthropic pour donner aux LLM accès à des outils externes. l402-kit fournit un serveur MCP prêt à l’emploi avec deux catégories d’outils :

Outils L402 génériques

Outil	Description
l402_fetch	Récupère n’importe quelle URL — paye automatiquement si elle retourne 402
l402_balance	Vérifie le budget Lightning restant
l402_spending_report	Récapitulatif complet des paiements de la session

Outils VERITY — services payants, paiement automatique inclus

Outil	Prix	Description
verity_btc_price	10 sats	Prix BTC en temps réel en USD, EUR, BRL
verity_worldstate	80 sats	Heure UTC + géolocalisation + météo locale
verity_search	100 sats	Recherche web, top 10 résultats organiques
verity_summarize	50 sats	Résumé par IA jusqu’à 50 000 caractères
verity_sentiment	30 sats	Score de sentiment + mots-clés
verity_scrape	200 sats	Scraping web converti en markdown propre
verity_domain_intel	500 sats	WHOIS + DNS + certificats SSL
verity_translate	50 sats	Traduction par IA vers 11 langues, compatible MDX
verity_integration	10 000 sats	Intégration complète de l402-kit pour tout dépôt GitHub

Les outils VERITY paient de manière autonome — aucune gestion manuelle de facture n’est nécessaire.

---

Configuration dans Claude Desktop

1. Installer Node.js ≥ 18

2. Configurer votre portefeuille

Blink

Modifiez claude_desktop_config.json :

{
  "mcpServers": {
    "l402": {
      "command": "npx",
      "args": ["l402-kit-mcp"],
      "env": {
        "BLINK_API_KEY": "your-blink-api-key",
        "BLINK_WALLET_ID": "your-wallet-id",
        "BUDGET_SATS": "2000"
      }
    }
  }
}

Alby

{
  "mcpServers": {
    "l402": {
      "command": "npx",
      "args": ["l402-kit-mcp"],
      "env": {
        "ALBY_TOKEN": "your-alby-access-token",
        "BUDGET_SATS": "2000"
      }
    }
  }
}

Pour un Alby Hub auto-hébergé, ajoutez :

"ALBY_HUB_URL": "https://your-hub.example.com"

Emplacement du fichier de configuration :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

3. Redémarrer Claude Desktop

Les outils l402_fetch, l402_balance et l402_spending_report apparaîtront dans la liste des outils de Claude.

---

Variables d’environnement

Variable	Obligatoire	Description
BLINK_API_KEY	Blink uniquement	Votre clé API Blink
BLINK_WALLET_ID	Blink uniquement	L’identifiant de votre portefeuille Blink
ALBY_TOKEN	Alby uniquement	Jeton d’accès Alby
ALBY_HUB_URL	optionnel	URL de base personnalisée pour Alby Hub
BUDGET_SATS	optionnel	Dépense maximale par session (défaut : 2000)

---

Utilisation des outils

Une fois le serveur démarré, Claude peut appeler VERITY et toute API protégée par L402 de manière autonome :

Vous : Quel est le prix du BTC en ce moment ?

Claude : [appelle verity_btc_price]
         [Payé 10 sats] {"bitcoin":{"usd":97500,"eur":89800,"brl":548000}}

         Bitcoin est actuellement à 97 500 USD (Coût : 10 sats)

Vous : Résume cet article : <colle 5 000 mots>

Claude : [appelle verity_summarize avec text="..."]
         [Payé 50 sats] {"summary":"..."}

Vous : Recherche "lightning network adoption 2026"

Claude : [appelle verity_search avec q="lightning network adoption 2026"]
         [Payé 100 sats] {"results":[...]}

Vous : Combien ai-je dépensé jusqu'à présent ?

Claude : [appelle l402_spending_report]
         === L402 Spending Report ===
         Total spent:  160 sats
         Remaining:    1840 sats

         By domain:
           l402kit.com: 160 sats

---

Point de terminaison HTTP MCP

En plus du package stdio, VERITY expose un serveur HTTP MCP actif — aucune installation requise :

POST https://l402kit.com/api/mcp
Content-Type: application/json

Tout client MCP supportant le transport HTTP streamable peut se connecter directement. Transmettez vos identifiants Blink dans les en-têtes :

X-BLINK-API-KEY: your-blink-api-key
X-BLINK-WALLET-ID: your-wallet-id

Initialisation :

{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}},"id":1}

Lister les outils :

{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}

Appeler un outil :

{"jsonrpc":"2.0","method":"tools/call","params":{"name":"verity_btc_price","arguments":{}},"id":3}

Le point de terminaison paye automatiquement les factures Lightning grâce à vos identifiants de portefeuille et retourne directement le résultat VERITY.

---

Registres MCP

l402-kit est référencé dans tous les principaux registres MCP :

Registre	Lien
Anthropic MCP Registry (officiel)	io.github.ThiagoDataEngineer/l402-kit
Glama	glama.ai/mcp/servers/@ShinyDapps/l402-kit
Smithery	smithery.ai/servers/shinydapps/l402-kit
mcp.so	rechercher l402-kit

Manifeste lisible par machine : GET https://l402kit.com/.well-known/mcp.json

---

Configuration avec Cursor

Ajoutez le même bloc de configuration dans les paramètres MCP de Cursor sous Paramètres → MCP Servers.

---

Configuration avec n’importe quel client MCP

Le serveur lit depuis stdin et écrit vers stdout (transport stdio) :

BLINK_API_KEY=xxx BLINK_WALLET_ID=yyy BUDGET_SATS=500 npx l402-kit-mcp

Tout client compatible MCP peut se connecter via le transport stdio.

---

Créer un serveur MCP personnalisé

Vous pouvez également intégrer L402Client directement dans votre propre serveur MCP :

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { L402Client, BlinkWallet } from "l402-kit";
import { z } from "zod";

const client = new L402Client({
  wallet: new BlinkWallet(process.env.BLINK_API_KEY!, process.env.BLINK_WALLET_ID!),
  budgetSats: 1000,
});

const server = new McpServer({ name: "my-agent", version: "1.0.0" });

server.tool(
  "fetch_weather",
  "Get current weather for a city — pays automatically",
  { city: z.string() },
  async ({ city }) => {
    const res = await client.fetch(`https://api.weather.com/current?city=${city}`);
    const text = await res.text();
    return { content: [{ type: "text", text }] };
  },
);

const transport = new StdioServerTransport();
await server.connect(transport);

---

Notes de sécurité

• Le plafond budgétaire (BUDGET_SATS) est votre principale protection — définissez-le de manière conservative
• Chaque processus npx l402-kit-mcp possède son propre budget en mémoire ; il se réinitialise au redémarrage
• Pour les agents en production, persistez le journal des dépenses via le callback onSpend vers un stockage externe