MCP Server

l402-kit को एक MCP tool के रूप में जोड़ें ताकि Claude Desktop, Cursor, और कोई भी MCP-compatible AI स्वचालित रूप से Lightning APIs का भुगतान कर सके।

MCP क्या है?

Model Context Protocol Anthropic का open standard है जो LLMs को external tools तक पहुँच देता है। l402-kit दो श्रेणियों के tools के साथ एक ready-made MCP server प्रदान करता है:

Generic L402 tools

Tool	विवरण
l402_fetch	कोई भी URL fetch करें — अगर 402 मिले तो स्वचालित रूप से भुगतान करता है
l402_balance	शेष Lightning budget जाँचें
l402_spending_report	इस session के भुगतानों का पूरा विवरण

VERITY tools — paid services, auto-pay included

Tool	मूल्य	विवरण
verity_btc_price	10 sats	USD, EUR, BRL में real-time BTC मूल्य
verity_worldstate	80 sats	UTC time + geolocation + स्थानीय मौसम
verity_search	100 sats	Web search, शीर्ष 10 organic परिणाम
verity_summarize	50 sats	50,000 chars तक AI summarization
verity_sentiment	30 sats	Sentiment score + keywords
verity_scrape	200 sats	Web scraping से clean markdown
verity_domain_intel	500 sats	WHOIS + DNS + SSL certificates
verity_translate	50 sats	11 locales में AI translation, MDX-aware
verity_integration	10,000 sats	किसी भी GitHub repo के लिए complete l402-kit integration

VERITY tools स्वायत्त रूप से भुगतान करते हैं — कोई manual invoice handling की आवश्यकता नहीं।

---

Claude Desktop में Setup

1. Node.js ≥ 18 इंस्टॉल करें

2. अपना wallet configure करें

Blink

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"
      }
    }
  }
}

Self-hosted Alby Hub के लिए, यह जोड़ें:

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

Config file का स्थान:

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

3. Claude Desktop पुनः प्रारंभ करें

l402_fetch, l402_balance, और l402_spending_report tools Claude की tool list में दिखाई देंगे।

---

Environment variables

Variable	आवश्यक	विवरण
BLINK_API_KEY	केवल Blink	आपकी Blink API key
BLINK_WALLET_ID	केवल Blink	आपका Blink wallet ID
ALBY_TOKEN	केवल Alby	Alby access token
ALBY_HUB_URL	वैकल्पिक	Custom Alby Hub base URL
BUDGET_SATS	वैकल्पिक	प्रति session अधिकतम खर्च (default: 2000)

---

Tools का उपयोग

एक बार server चलने के बाद, Claude स्वायत्त रूप से VERITY और किसी भी L402-protected API को call कर सकता है:

You: What's the BTC price right now?

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

        Bitcoin is currently $97,500 USD (Cost: 10 sats)

You: Summarize this article: <pastes 5,000 words>

Claude: [calls verity_summarize with text="..."]
        [Paid 50 sats] {"summary":"..."}

You: Search for "lightning network adoption 2026"

Claude: [calls verity_search with q="lightning network adoption 2026"]
        [Paid 100 sats] {"results":[...]}

You: How much have I spent so far?

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

        By domain:
          l402kit.com: 160 sats

---

HTTP MCP endpoint

stdio package के अतिरिक्त, VERITY एक live HTTP MCP server प्रदान करता है — किसी installation की आवश्यकता नहीं:

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

कोई भी MCP client जो streamable HTTP transport को support करता है, सीधे connect कर सकता है। अपनी Blink credentials headers के रूप में दें:

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

Initialize:

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

Tools की सूची:

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

Tool call करें:

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

यह endpoint आपकी wallet credentials का उपयोग करके Lightning invoices का स्वचालित भुगतान करता है और VERITY का परिणाम सीधे वापस करता है।

---

MCP registries

l402-kit सभी प्रमुख MCP registries में सूचीबद्ध है:

Registry	लिंक
Anthropic MCP Registry (official)	io.github.ThiagoDataEngineer/l402-kit
Glama	glama.ai/mcp/servers/@ShinyDapps/l402-kit
Smithery	smithery.ai/servers/shinydapps/l402-kit
mcp.so	l402-kit खोजें

Machine-readable manifest: GET https://l402kit.com/.well-known/mcp.json

---

Cursor के साथ Setup

वही config block Settings → MCP Servers के अंतर्गत Cursor की MCP settings में जोड़ें।

---

किसी भी MCP client के साथ Setup

Server stdin से पढ़ता है / stdout पर लिखता है (stdio transport):

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

कोई भी MCP-compatible client stdio transport का उपयोग करके connect कर सकता है।

---

Custom MCP server बनाना

आप अपने खुद के MCP server में L402Client को सीधे embed भी कर सकते हैं:

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);

---

सुरक्षा संबंधी नोट्स

• Budget cap (BUDGET_SATS) आपकी प्राथमिक सुरक्षा है — इसे सावधानीपूर्वक कम रखें
• प्रत्येक npx l402-kit-mcp process की अपनी in-memory budget होती है; restart पर यह reset हो जाती है
• Production agents के लिए, spending log को onSpend callback के माध्यम से किसी external store में persist करें