MCP Server

Adicione l402-kit como uma ferramenta MCP para que Claude Desktop, Cursor e qualquer IA compatível com MCP possa pagar Lightning APIs automaticamente.

O que é MCP?

Model Context Protocol é o padrão aberto da Anthropic para fornecer aos LLMs acesso a ferramentas externas. O l402-kit inclui um servidor MCP pronto para uso com duas categorias de ferramentas:

Ferramentas L402 genéricas

Ferramenta	Descrição
l402_fetch	Acessa qualquer URL — paga automaticamente se retornar 402
l402_balance	Verifica o saldo restante de Lightning
l402_spending_report	Detalhamento completo dos pagamentos desta sessão

Ferramentas VERITY — serviços pagos, pagamento automático incluído

Ferramenta	Preço	Descrição
verity_btc_price	10 sats	Preço do BTC em tempo real em USD, EUR, BRL
verity_worldstate	80 sats	Hora UTC + geolocalização + clima local
verity_search	100 sats	Busca na web, top 10 resultados orgânicos
verity_summarize	50 sats	Sumarização por IA de até 50.000 caracteres
verity_sentiment	30 sats	Pontuação de sentimento + palavras-chave
verity_scrape	200 sats	Web scraping para markdown limpo
verity_domain_intel	500 sats	WHOIS + DNS + certificados SSL
verity_translate	50 sats	Tradução por IA para 11 idiomas, compatível com MDX
verity_integration	10.000 sats	Integração completa do l402-kit para qualquer repositório GitHub

As ferramentas VERITY pagam de forma autônoma — nenhum tratamento manual de faturas é necessário.

---

Configuração no Claude Desktop

1. Instale o Node.js ≥ 18

2. Configure sua carteira

Blink

Edite o arquivo 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"
      }
    }
  }
}

Para um Alby Hub auto-hospedado, adicione:

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

Localização do arquivo de configuração:

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

3. Reinicie o Claude Desktop

As ferramentas l402_fetch, l402_balance e l402_spending_report aparecerão na lista de ferramentas do Claude.

---

Variáveis de ambiente

Variável	Obrigatório	Descrição
BLINK_API_KEY	Apenas Blink	Sua chave de API do Blink
BLINK_WALLET_ID	Apenas Blink	ID da sua carteira Blink
ALBY_TOKEN	Apenas Alby	Token de acesso do Alby
ALBY_HUB_URL	opcional	URL base personalizada do Alby Hub
BUDGET_SATS	opcional	Gasto máximo por sessão (padrão: 2000)

---

Usando as ferramentas

Com o servidor em execução, o Claude pode chamar VERITY e qualquer API protegida por L402 de forma autônoma:

Você: Qual é o preço do BTC agora?

Claude: [chama verity_btc_price]
        [Pagou 10 sats] {"bitcoin":{"usd":97500,"eur":89800,"brl":548000}}

        O Bitcoin está atualmente a $97.500 USD (Custo: 10 sats)

Você: Resuma este artigo: <cola 5.000 palavras>

Claude: [chama verity_summarize com text="..."]
        [Pagou 50 sats] {"summary":"..."}

Você: Pesquise por "lightning network adoption 2026"

Claude: [chama verity_search com q="lightning network adoption 2026"]
        [Pagou 100 sats] {"results":[...]}

Você: Quanto eu gastei até agora?

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

        By domain:
          l402kit.com: 160 sats

---

Endpoint HTTP MCP

Além do pacote stdio, o VERITY expõe um servidor HTTP MCP ativo — sem necessidade de instalação:

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

Qualquer cliente MCP que suporte transporte HTTP streamable pode se conectar diretamente. Passe suas credenciais do Blink como cabeçalhos:

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

Inicializar:

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

Listar ferramentas:

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

Chamar uma ferramenta:

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

O endpoint paga faturas Lightning automaticamente usando suas credenciais de carteira e retorna o resultado do VERITY diretamente.

---

Registros MCP

O l402-kit está listado em todos os principais registros MCP:

Registro	Link
Anthropic MCP Registry (oficial)	io.github.ThiagoDataEngineer/l402-kit
Glama	glama.ai/mcp/servers/@ShinyDapps/l402-kit
Smithery	smithery.ai/servers/shinydapps/l402-kit
mcp.so	pesquise l402-kit

Manifesto legível por máquina: GET https://l402kit.com/.well-known/mcp.json

---

Configuração com Cursor

Adicione o mesmo bloco de configuração nas configurações MCP do Cursor em Settings → MCP Servers.

---

Configuração com qualquer cliente MCP

O servidor lê de stdin / escreve em stdout (transporte stdio):

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

Qualquer cliente compatível com MCP pode se conectar usando o transporte stdio.

---

Construindo um servidor MCP personalizado

Você também pode incorporar o L402Client diretamente no seu próprio servidor 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);

---

Notas de segurança

• O limite de orçamento (BUDGET_SATS) é sua principal proteção — defina-o de forma conservadora
• Cada processo npx l402-kit-mcp possui seu próprio orçamento em memória; ele é redefinido ao reiniciar
• Para agentes em produção, persista o registro de gastos via callback onSpend em um armazenamento externo