> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> Füge l402-kit als MCP-Tool hinzu, damit Claude Desktop, Cursor und jede MCP-kompatible KI automatisch Lightning-APIs bezahlen kann.
## Was ist MCP?
[Model Context Protocol](https://modelcontextprotocol.io) ist Anthropics offener Standard, um LLMs Zugang zu externen Tools zu geben. l402-kit liefert einen fertigen MCP-Server mit zwei Tool-Kategorien:
### Generische L402-Tools
| Tool | Beschreibung |
| ---------------------- | ------------------------------------------------------------------ |
| `l402_fetch` | Beliebige URL abrufen — zahlt automatisch, wenn sie 402 zurückgibt |
| `l402_balance` | Verbleibendes Lightning-Budget prüfen |
| `l402_spending_report` | Vollständige Aufschlüsselung der Zahlungen dieser Sitzung |
### VERITY-Tools — kostenpflichtige Dienste, automatische Zahlung inklusive
| Tool | Preis | Beschreibung |
| --------------------- | ----------: | ------------------------------------------------------------ |
| `verity_btc_price` | 10 sats | Echtzeit-BTC-Preis in USD, EUR, BRL |
| `verity_worldstate` | 80 sats | UTC-Zeit + Geolokalisierung + lokales Wetter |
| `verity_search` | 100 sats | Websuche, Top-10-Ergebnisse |
| `verity_summarize` | 50 sats | KI-Zusammenfassung bis 50.000 Zeichen |
| `verity_sentiment` | 30 sats | Sentiment-Score + Schlüsselwörter |
| `verity_scrape` | 200 sats | Web-Scraping zu sauberem Markdown |
| `verity_domain_intel` | 500 sats | WHOIS + DNS + SSL-Zertifikate |
| `verity_translate` | 50 sats | KI-Übersetzung in 11 Sprachen, MDX-fähig |
| `verity_integration` | 10.000 sats | Vollständige l402-kit-Integration für beliebige GitHub-Repos |
VERITY-Tools zahlen autonom — keine manuelle Rechnungsverarbeitung erforderlich.
***
## Einrichtung in Claude Desktop
### 1. Node.js ≥ 18 installieren
### 2. Wallet konfigurieren
`claude_desktop_config.json` bearbeiten:
```json theme={null}
{
"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"
}
}
}
}
```
```json theme={null}
{
"mcpServers": {
"l402": {
"command": "npx",
"args": ["l402-kit-mcp"],
"env": {
"ALBY_TOKEN": "your-alby-access-token",
"BUDGET_SATS": "2000"
}
}
}
}
```
Für einen selbst gehosteten Alby Hub ergänzen:
```json theme={null}
"ALBY_HUB_URL": "https://your-hub.example.com"
```
**Speicherort der Konfigurationsdatei:**
* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
### 3. Claude Desktop neu starten
Die Tools `l402_fetch`, `l402_balance` und `l402_spending_report` erscheinen anschließend in Claudes Tool-Liste.
***
## Umgebungsvariablen
| Variable | Erforderlich | Beschreibung |
| ----------------- | :----------: | ------------------------------------------------ |
| `BLINK_API_KEY` | Nur Blink | Dein Blink-API-Schlüssel |
| `BLINK_WALLET_ID` | Nur Blink | Deine Blink-Wallet-ID |
| `ALBY_TOKEN` | Nur Alby | Alby-Zugriffstoken |
| `ALBY_HUB_URL` | optional | Benutzerdefinierte Alby Hub-Basis-URL |
| `BUDGET_SATS` | optional | Maximale Ausgaben pro Sitzung (Standard: `2000`) |
***
## Tools verwenden
Sobald der Server läuft, kann Claude VERITY und jede L402-geschützte API autonom aufrufen:
```
Du: Was ist der aktuelle BTC-Preis?
Claude: [ruft verity_btc_price auf]
[10 sats bezahlt] {"bitcoin":{"usd":97500,"eur":89800,"brl":548000}}
Bitcoin steht aktuell bei $97.500 USD (Kosten: 10 sats)
```
```
Du: Fasse diesen Artikel zusammen:
Claude: [ruft verity_summarize mit text="..." auf]
[50 sats bezahlt] {"summary":"..."}
```
```
Du: Suche nach "lightning network adoption 2026"
Claude: [ruft verity_search mit q="lightning network adoption 2026" auf]
[100 sats bezahlt] {"results":[...]}
```
```
Du: Wie viel habe ich bisher ausgegeben?
Claude: [ruft l402_spending_report auf]
=== L402 Spending Report ===
Total spent: 160 sats
Remaining: 1840 sats
By domain:
l402kit.com: 160 sats
```
***
## HTTP-MCP-Endpunkt
Zusätzlich zum stdio-Paket stellt VERITY einen live **HTTP-MCP-Server** bereit — keine Installation erforderlich:
```
POST https://l402kit.com/api/mcp
Content-Type: application/json
```
Jeder MCP-Client, der streamable HTTP-Transport unterstützt, kann sich direkt verbinden. Übergib deine Blink-Zugangsdaten als Header:
```
X-BLINK-API-KEY: your-blink-api-key
X-BLINK-WALLET-ID: your-wallet-id
```
**Initialisieren:**
```json theme={null}
{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}},"id":1}
```
**Tools auflisten:**
```json theme={null}
{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}
```
**Tool aufrufen:**
```json theme={null}
{"jsonrpc":"2.0","method":"tools/call","params":{"name":"verity_btc_price","arguments":{}},"id":3}
```
Der Endpunkt bezahlt Lightning-Rechnungen automatisch über deine Wallet-Zugangsdaten und gibt das VERITY-Ergebnis direkt zurück.
***
## MCP-Verzeichnisse
l402-kit ist in allen wichtigen MCP-Verzeichnissen gelistet:
| Verzeichnis | Link |
| ---------------------------------- | ---------------------------------------------------------------------------------------------- |
| Anthropic MCP Registry (offiziell) | `io.github.ThiagoDataEngineer/l402-kit` |
| Glama | [glama.ai/mcp/servers/@ShinyDapps/l402-kit](https://glama.ai/mcp/servers/@ShinyDapps/l402-kit) |
| Smithery | [smithery.ai/servers/shinydapps/l402-kit](https://smithery.ai/servers/shinydapps/l402-kit) |
| mcp.so | `l402-kit` suchen |
Maschinenlesbares Manifest: `GET https://l402kit.com/.well-known/mcp.json`
***
## Einrichtung mit Cursor
Füge denselben Konfigurationsblock in Cursors MCP-Einstellungen unter **Einstellungen → MCP Servers** hinzu.
***
## Einrichtung mit einem beliebigen MCP-Client
Der Server liest von `stdin` und schreibt nach `stdout` (stdio-Transport):
```bash theme={null}
BLINK_API_KEY=xxx BLINK_WALLET_ID=yyy BUDGET_SATS=500 npx l402-kit-mcp
```
Jeder MCP-kompatible Client kann sich über den stdio-Transport verbinden.
***
## Eigenen MCP-Server erstellen
Du kannst `L402Client` auch direkt in deinen eigenen MCP-Server einbetten:
```typescript theme={null}
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);
```
***
## Sicherheitshinweise
* Die Budget-Obergrenze (`BUDGET_SATS`) ist deine wichtigste Schutzmaßnahme — setze sie konservativ
* Jeder `npx l402-kit-mcp`-Prozess hat sein eigenes In-Memory-Budget; es wird beim Neustart zurückgesetzt
* Für produktive Agenten das Ausgabenprotokoll über den `onSpend`-Callback in einem externen Speicher persistieren