MCP Monetize - Drop-in Billing & Capability Token Engine

io.github.RitualDev-Lab由 GitHub 帳號 RitualDev-Lab 發布v0.1.3更新於 Nov 19, 2026

Drop-in billing, paywalls, and capability token middleware for MCP servers.

發布方自己的服務:Engine Travel Platform

已驗證STDIO僅桌面開發者工具商業與電商

概覽

AI 產生的概覽

可直接嵌入的計費與付費牆中介軟體函式庫,讓 MCP 伺服器作者依工具呼叫次數或訂閱向使用者收費。

可以做什麼
  • 包裝 MCP 工具處理函式,讓每次呼叫都依免費額度與付費餘額計量
  • 額度用盡時執行配額限制,並回傳帶有 Dodo Payments 或 Stripe 結帳連結的付費牆訊息
  • 將額度餘額儲存在記憶體、SQLite、Redis/Upstash 或 JSON 檔案
  • 處理 Dodo 與 Stripe 付款 webhook,自動為使用者補充額度
  • 可設定免費呼叫次數、價格文案、付款服務商以及自訂使用者 ID 擷取方式
適用情境
適合自行發布 MCP 伺服器的開發者,希望依工具使用量收費、提供免費試用額度,或在不自建計費後端的情況下加入訂閱或按次計費。
執行需求
以本機 npm 套件(Node.js)形式匯入到你自己的 MCP 伺服器程式碼中執行。需要一個 Dodo Payments 或 Stripe 結帳/付款連結;若需 webhook 結算,還需 DODO_WEBHOOK_SECRET 或 DODO_PAYMENTS_WEBHOOK_KEY 以及 STRIPE_WEBHOOK_SECRET。Redis 轉接器需要 UPSTASH_REDIS_REST_URL 與 UPSTASH_REDIS_REST_TOKEN。
安裝前請注意
涉及真實付款:使用者會被導向外部結帳連結,額度依 webhook 事件發放,因此 webhook 簽章驗證與金鑰管理很重要。DODO_WEBHOOK_SECRET、STRIPE_WEBHOOK_SECRET 等 webhook 金鑰屬敏感資訊。預設記憶體儲存重啟後會遺失餘額,JSON 檔案儲存會把額度資料寫入磁碟。它是供伺服器作者使用的函式庫,而非現成的託管計費服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MCP Monetize - Drop-in Billing & Capability Token Engine,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

💳 mcp-monetize

Drop-in billing, credit tracking, and paywall middleware for Model Context Protocol (MCP) servers.
Monetize your AI agent tools in 3 lines of code with Dodo Payments & Stripe.

[npm version] [License: MIT] [MCP Compatible]


⚡ The Problem

Developers are publishing thousands of Model Context Protocol (MCP) servers for Claude Desktop, Cursor, and Windsurf. But until now:

  • There was no standard way to charge users per tool invocation or per month.
  • Tool creators bear the heavy server, LLM API, and scraping costs while users consume unlimited queries for free.

mcp-monetize solves this by giving MCP server creators an effortless 3-line drop-in middleware that manages quotas, verifies credits, and returns interactive payment links directly inside the agent chat when quotas run out.

mcp-monetize vs. mcp-builder-kit

PackageRoleWhen to Use
mcp-monetize (this repo)Commercial Billing Clearinghouse & Paywall SDKMonetizing MCP tool invocations with Universal Pre-Paid MCP Credits, usage quotas, Dodo Payments / Stripe checkout links, and webhook-driven credit settlement.
@ritualdev-lab/mcp-builder-kit (RitualDev-Lab/mcp-builder-kit)Free Open-Source (Apache-2.0) MCP Scaffolding CLIBootstrapping TypeScript/Python MCP servers (stdio / streamable-http), wrapping tools with --with-agentshield redaction, converting OpenAPI/GraphQL/Protobuf specs, and running protocol conformance tests.

🚀 Quickstart (3 Lines of Code)

1. Install

bash
npm install @ritualdev-lab/mcp-monetize# orpnpm add @ritualdev-lab/mcp-monetize

2. Wrap your MCP tool handler

typescript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";import { withMcpMonetization } from "@ritualdev-lab/mcp-monetize";import { z } from "zod";
const server = new McpServer({ name: "market-oracle", version: "1.0.0" });
server.tool(  "query_stock_valuation",  { ticker: z.string() },  withMcpMonetization(    async ({ ticker }) => {      const data = await fetchValuation(ticker);      return { content: [{ type: "text", text: `Valuation for ${ticker}: $142.50` }] };    },    {      // Your Dodo Payments or Stripe payment link      checkoutUrl: "https://checkout.dodopayments.com/buy/pdt_0NpjONGugY5QkrFDUaPva",      priceLabel: "$5 for 1,000 queries",      freeTierCalls: 5 // 5 free queries for every new user    }  ));

🖼️ How the Agent Sees the Paywall

When a user in Claude Desktop, Cursor, or Windsurf exhausts their free calls, the agent automatically receives structured markdown prompting the user to top up:

markdown
🔒 Usage Limit Reached for `query_stock_valuation`
Your complimentary tool credits have been exhausted. To continue executing queries with uninterrupted speed:
### 💳 Unlock Instant Access ($5 for 1,000 queries)👉 [Click Here to Activate / Top-Up Credits via Secure Checkout](https://checkout.dodopayments.com/buy/pdt_xyz)
---*User Ref: `dev_client_01` • Payments securely powered by Dodo Payments & Stripe.*

Once the user completes payment via UPI, Credit Card, or Apple Pay, their webhook or API key activates paid credits and execution resumes seamlessly!


⚙️ Configuration Options

OptionTypeDefaultDescription
checkoutUrlstring | (userId: string) => stringRequiredDodo Payments product link or Stripe Payment link. Can be dynamic function.
freeTierCallsnumber5Number of free calls given to each new user before paywall triggers.
priceLabelstring"$0.05 / call"Pricing description displayed inside the paywall message.
provider"dodo" | "stripe" | "custom""dodo"Payment provider tag.
storeTokenStoreMemoryTokenStoreStorage engine (MemoryTokenStore or JsonFileTokenStore).
getUserId(args, extra) => stringAutomaticCustom function to extract workspace or user ID.
customPaywallMessage(info) => stringStandard templateOptional custom paywall markdown generator.

💾 Storage Adapters

1. In-Memory (Default)

Fastest, zero-dependency. Great for local desktop tools.

typescript
import { MemoryTokenStore } from "mcp-monetize";const store = new MemoryTokenStore(5);

2. SQLite Database Persistence

Built-in node:sqlite store with zero native dependencies. Supports thread-safe transactions and atomic balances.

typescript
import { SqliteTokenStore } from "mcp-monetize/adapters/sqlite";const store = new SqliteTokenStore("./data/mcp-credits.sqlite", 10);

3. Serverless Redis / Upstash

Designed for cloud-hosted MCP servers (Render, Fly.io, Railway, AWS Lambda).

typescript
import { RedisTokenStore } from "mcp-monetize/adapters/redis";const store = new RedisTokenStore({  url: process.env.UPSTASH_REDIS_REST_URL!,  token: process.env.UPSTASH_REDIS_REST_TOKEN!,  defaultFreeCredits: 10});

4. JSON File Persistence

Zero database dependencies; persists user credits across server restarts in mcp-credits.json.

typescript
import { JsonFileTokenStore } from "mcp-monetize";const store = new JsonFileTokenStore("./data/credits.json", 10);

🤝 Webhook Fulfillment Engine (Turnkey Dodo & Stripe)

Use the built-in PaymentWebhookHandler to process checkouts and replenish user credits automatically:

typescript
import { PaymentWebhookHandler, SqliteTokenStore } from "mcp-monetize";
const store = new SqliteTokenStore("./data/tokens.sqlite");const webhooks = new PaymentWebhookHandler({  store,  dodoWebhookSecret: process.env.DODO_WEBHOOK_SECRET || process.env.DODO_PAYMENTS_WEBHOOK_KEY,  stripeWebhookSecret: process.env.STRIPE_WEBHOOK_SECRET});
// In your Express or Fastify server:app.post("/api/webhooks/dodo", async (req, res) => {  const result = await webhooks.handleDodoWebhook(req.body, req.headers["x-dodo-signature"]);  res.status(result.success ? 200 : 400).json(result);});

🔐 Cryptographic License Key Verification

For off-line or client-side MCP distribution (where users supply a license key in claude_desktop_config.json):

typescript
import { McpLicenseValidator } from "mcp-monetize";
const validator = new McpLicenseValidator("your_hmac_secret_key_min_32_chars");
// Issue a 30-day license key:const token = validator.generateLicenseKey("user_456", 30);
// Verify inside your tool:const check = validator.verifyLicense(token);if (check.valid) {  console.log(`Verified user ${check.userId}, expires: ${check.expiresAt}`);}

📦 Turnkey Starter Kit & Production Examples

Looking for ready-to-deploy boilerplates? Check the examples/ directory:

  1. examples/01-weather-api-server.ts — Pay-per-query API ($5 for 500 calls).
  2. examples/02-sql-agent-server.ts — Monthly recurring subscription with HMAC license verification.
  3. examples/03-web-scraper-server.ts — Usage credits with turnkey Dodo checkout webhook.

👉 Get the complete package with instant setup at ritualdev.in/mcp-starter-kit.


📜 License

MIT © RitualDev Lab



💖 Sponsor & Support

If you find this project valuable, consider supporting our open-source development:

[Sponsor on Dodo Payments] [Interactive Donation Portal] [GitHub Sponsors]


🛡️ Community & Governance

來源:README.md,提交 f4d97f4

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次,以列出其工具,但未能完成:伺服器未能啟動。

版本歷史

1
  1. v0.1.3最新Nov 19, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Engine 整合