MCP sunucunuzu 10 dakikada para kazanın.
AI ajanlarının MCP sunucunuzu her çağrıda, USDC ile, imzalı web kancaları ve denetim günlükleri ile ödemesine izin verin. x402 uyumlu. Drop-in ara yazılım.
Bir MCP sunucusu inşa ettiniz. Binlerce müşteri bunu ücretsiz olarak kullanıyor.
MCP sunucunuzu, Claude Desktop, Cursor ve Cline istemcileri bu yeteneğe ihtiyaç duyduğu için gönderdiniz. Söylentiler yayıldı. Artık tanımadığınız AI ajanlarından günde binlerce ücretli araç çağrısı yapıyorsunuz. Çıkış faturanız gerçek. Temel hizmet için API anahtarınız gerçek. Bakım süreniz gerçek. Gelir sıfır.
Üç seçeneğiniz var. Ücretsiz tutun ve altyapıya para harcayın. Bunu manuel API anahtarlarının arkasında kapatın (ve kayıt formlarının sürtünmesi nedeniyle ajan trafiğinin %95'ini kaybedin). Ya da AI ajanlarının gerçekten tamamlayabileceği bir ödeme katmanı ekleyin - bu, tam olarak 402 Ödeme Gereklidir + USDC için inşa edilmiştir.
Blockchain0x, üçüncü seçenektir. MCP sunucunuz API'mize işaret eder. Bir AI istemcisi ücretli bir aracı aradığında, yanıt, barındırılan bir ödeme URL'si ile 402'dir. İstemci (veya insan denetleyicisi) USDC ile ödeme yapar. Webhook'unuz tetiklenir. O istemciden gelen bir sonraki çağrı başarılı olur. Tüm şekil x402 olarak adlandırılır ve bu, Coinbase'in bu kesin kalıp için yayımladığı protokoldür.
Nasıl 402 Ödeme Gereklidir programatik bir ödeme sürecine dönüşür.
HTTP durum kodu 402, spesifikasyon ilk yazıldığından beri var olmuştur ancak hiçbir zaman standart bir uygulaması olmamıştır. Coinbase'in x402 protokolü nihayet buna bir standart getiriyor. Şekil basittir: aracınız 402 zorluğu döndürür (ödemeyi nasıl yapacağınızı tanımlayan yapılandırılmış bir JSON gövdesi); istemci öder ve yeniden dener; çağrı başarılı olur. @blockchain0x/mcp'den requirePayment, sizin için o zorlama gövdesini oluşturur.
{
"error": "payment_required",
"amountUsdc": "0.02",
"payTo": "0xYourMcpAgentAddress",
"hostedUrl": "https://pay.blockchain0x.com/checkout/docs-search",
"network": "mainnet",
"description": "docs search"
}Dört durum
- Ödenmemiş çağrı: AI istemcisi bir ücretli aracı çağırır. İşleyiciniz kendi ücretli durumunuzu kontrol eder, ödeyenin ödenmiş olarak işaretlenmediğini bulur ve requirePayment'dan 402 zorlama gövdesini bir araç hatası olarak döner.
- Ödeme: Müşteri, hostedUrl'yi takip eder ve hosted ödeme sayfasında USDC transferini Base üzerinde tamamlar (ya bir x402 uyumlu cüzdan aracılığıyla programatik olarak ya da QR kodu aracılığıyla manuel olarak).
- Webhook: Blockchain0x, zincir onayından birkaç saniye içinde payment.received'i uç noktanıza gönderir. Bunu webhooks.verify ile doğrularsınız ve ödeyeni kendi depolamanızda ödenmiş olarak kaydedersiniz.
- Tekrar dene: Müşteri orijinal MCP araç çağrısını tekrar dener. İşleyiciniz artık ödeyenin ödenmiş olarak işaretlendiğini görür, aracı çalıştırır ve gerçek sonucu döner.
Her ödeme, Blockchain0x kontrol panelinizde kaydedilir ve her payment.received webhook kendi günlüklerinize düşer. Ödenmiş durumu ve webhook işleyicisini sahip olduğunuz için, her araç ve her ödeyici için gelir analitiği, zaten sakladığınız verilerden çıkar.
Tam çalışan bir örnek.
requirePayment, @blockchain0x/mcp'den 402 zorluğunu oluşturur; webhooks.verify, @blockchain0x/node'dan onayı doğrular. Arada iki küçük parçayı siz sahiplenirsiniz: aracın içindeki ücretli durum kontrolü ve bir ödeyeni ücretli olarak işaretleyen webhook işleyici. Aşağıda, bir ücretli aracı ve onun webhook uç noktasını açığa çıkaran tam bir MCP sunucusu bulunmaktadır.
import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { requirePayment } from "@blockchain0x/mcp";
import { webhooks } from "@blockchain0x/node";
const server = new McpServer({ name: "docs-search", version: "1.0.0" });
// You decide who counts as paid. Back this with Redis/Postgres in production.
const paid = new Set<string>();
server.tool(
"search_docs",
"Semantic search across our docs",
{ query: { type: "string" }, payer: { type: "string" } },
async ({ query, payer }) => {
if (!paid.has(`search_docs:${payer}`)) {
// Not paid yet: build an x402-compatible 402 challenge and return its
// body as a tool error. requirePayment is a challenge builder - it does
// not gate the call for you; this check is yours.
const { body } = requirePayment({
amountUsdc: "0.02",
payTo: "0xYourMcpAgentAddress",
hostedUrl: "https://pay.blockchain0x.com/checkout/docs-search",
description: "docs search",
});
return { content: [{ type: "text", text: JSON.stringify(body) }], isError: true };
}
const results = await runVectorSearch(query);
return { content: [{ type: "text", text: JSON.stringify(results) }] };
},
);
// Your webhook endpoint marks a payer as paid once the checkout settles.
const app = express();
app.post("/webhooks/blockchain0x", express.raw({ type: "*/*" }), (req, res) => {
const r = webhooks.verify({ headers: req.headers, rawBody: req.body, secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET! });
if (!r.ok) return res.status(400).json({ code: r.code });
if (r.eventType === "payment.received") {
// Resolve (tool, payer) from the reference you encoded in hostedUrl, then:
paid.add("search_docs:0xPayer");
}
res.json({ received: true });
});Kurulum adımları
- 1Blockchain0x ajan cüzdanı oluşturun MCP sunucunuz için, API ve webhook erişimini içeren bir planda. Kullanacağınız cüzdan adresini payTo olarak not edin.
- 2Paketleri yükleyin:
npm install @blockchain0x/mcp @blockchain0x/node - 3Ortam değişkenlerini ayarlayın: BLOCKCHAIN0X_API_KEY (MCP sunucusu bunu Authorization: Bearer olarak gönderir) ve BLOCKCHAIN0X_WEBHOOK_SECRET (dashboard imzalama sırrı, webhooks.verify'nin kontrol ettiği değer).
- 4Ücretli araçlarınızı kapatın kendi ücretli durumunuzu kontrol ederek ve arayanın ödeme yapmadığı durumlarda requirePayment zorlama gövdesini döndürerek. Ücretsiz araçları kapalı bırakın.
- 5Webhook uç noktasını yapılandırın Blockchain0x kontrol panelinde (örneğin /webhooks/blockchain0x), ardından her teslimatı webhooks.verify ile doğrulayın ve ödeyeni payment.received üzerinde ödenmiş olarak işaretleyin.
- 6Dağıtım. Ücretli aracınıza ulaşan ilk AI istemcisi 402 alır, öder ve bir sonraki çağrı başarılı olur. Ödemeyi kontrol panelinde 10 saniye içinde görürsünüz.
Blockchain0x MCP server'ını npx @blockchain0x/mcp (stdio) ile veya mcp.blockchain0x.com üzerindeki hosted Streamable HTTP container ile de çalıştırabilirsiniz. webhook payload shape'leri dahil tam kurulum documentation içindedir.
İşleyicinizdeki en önemli tek karar.
Ödenmiş durumu siz sahip olduğunuz için, bir ödemenin ne kadar süreyle geçerli olacağını da siz belirlersiniz. Bir müşteri bir araç için ödeme yaptıktan sonra, onları belirli bir süre için ödenmiş olarak işaretli tutun ve bu süre içinde yeni bir ödeme olmadan çağrılara izin verin. Pencereyi çok kısa ayarlarsanız, her çağrıda müşterileri ödeme sürtünmesi ile cezalandırırsınız; çok uzun ayarlarsanız, bir ucuz ödemenin ardından pahalı işlemleri hediye edersiniz. Redis/Postgres anahtarınızda bir TTL ayarlamak, bunu uygulamanın en basit yoludur.
Tavsiye ettiğimiz pencereler
| Araç türü | Pencere | Neden |
|---|---|---|
| Ucuz sorgulama ($0.01-$0.05) | 60 saniye | Oturumu vermeden doğal yeniden denemeleri ve takip çağrılarını absorbe eder. |
| Orta fiyatlı çıkarım ($0.10-$1) | 30 saniye | Çağrı başına ödeme doğru şekildedir; kısa önbellek geçici hatalarda yeniden denemeyi yönetir. |
| Pahalı uzun bağlam ($1-$10) | 0 saniye (önbellek yok) | Her çağrı kendi ücretli etkinliğidir; önbellek yok. |
| Abonelik tarzı araçlar | 24 saat | Penceredeki sınırsız çağrılar için günde bir kez ödeme yapın. Daha düşük sürtünme ile daha yüksek gelir. |
Ödenmiş durumu (ödeyen cüzdan, araç) çiftine göre anahtarlayın, örneğin search_docs:0xPayer ile yaptığı gibi. İki farklı istemci aynı araca erişiyor, her biri ayrı ayrı ödüyor. Aynı istemci iki farklı araca erişiyor, iki ayrı ödeme gereklidir. İsterseniz daha geniş bir kapsam belirleyebilirsiniz (tüm araçlar için ödeyen başına); ödeyen başına araç granülaritesi, fiyatlandırmanın adil hissettirmesini sağlar.
MCP sunucuları için çalışan dört fiyatlandırma şekli.
Fiyatlandırma sizin kararınız - ara katmanda her araç için miktarı belirliyorsunuz. Aşağıda en sık gördüğümüz dört model ve hangi araç şekillerine uydukları yer alıyor.
Çağrı başına mikro fiyatlandırma
$0.01 - $0.05 per çağrıArama, sorgulama, sınıflandırma, format dönüşümü - yüksek hacimli ucuz işlemler.
Müşteriler için en düşük sürtünme; maliyeti tam olarak kullanım ile eşleştirir.
En yüksek işlem genel gideri; yalnızca yüksek çağrı hacminde çalışır.
Çağrı başına orta fiyatlandırma
$0.10 - $1.00 per çağrıLLM çıkarımı, üretimi, içerik üretimi, her çağrının gerçek iş yaptığı her şey.
Dengeli - çağrı başına net değer, yönetilebilir işlem sayısı.
Her çağrı başına daha yüksek sürtünme; müşteriler bazen bu fiyat noktasında abonelikleri tercih eder.
Çağrı başına yüksek fiyatlandırma
$1 - $10 per çağrıUzun bağlam üretimi, belge işleme, çok adımlı orkestrasyon, pahalı üçüncü taraf API sarmalama.
Çağrı başına marj anlamlıdır; başarısız ödemeler tolere edilebilir kayıplardır.
Müşteriler bu fiyatta sıkı pazarlık yapar; iade talepleri bekleyin.
Abonelik penceresi
$5 - $50 per 24h penceresi (veya $X aylık)Bir oturumda birçok çağrı yapan ve çağrı başına ödeme zorluğuna tahammül etmeyen müşteriler.
Müşteri başına daha yüksek gelir; çağrı başına daha az genel gider.
Daha düşük keşfedilebilirlik; müşterilerin önceden taahhüt vermesi gerekir. Genellikle hibrit fiyatlandırma için çağrı başına ile birleştirilir.
Birçok operatör desenleri karıştırır: çağrı başına mikro fiyatlandırmada ucuz araçlar, çağrı başına yüksek fiyatlandırmada pahalı araçlar ve ağır kullanıcılar için 24 saatlik bir abonelik penceresi. Üçünü de aynı MCP sunucusunda çalıştırmanızı engelleyen hiçbir şey yoktur; her araç, requirePayment'da kendi amountUsdc'sini ve işleyicinizde kendi ücretli penceresini ayarlar.
Pro, neredeyse her MCP sunucusu için doğru plandır.
MCP sunucu operatörleri neredeyse her zaman Pro'dan başlar çünkü API yazma erişimi ve webhook'lar ilk günden itibaren gereklidir: Ücretsiz yalnızca okunabilir ve bir ücretli aracın payment.received webhook'larını alması ve doğrulaması gerekir. Kesin ajan başına maliyet ve işlem ücreti katmanlarının nerede olduğunu görmek için fiyatlandırma sayfasına bakın; kısa versiyonu, gerçek ödeme hacmi yapan herhangi bir sunucunun Pro'nun kendini ödeyeceği noktayı çoktan geçtiğidir.
- Free: API ve kontrol paneliyle denemeler yapmak için uygundur. Üretim ortamındaki ücretli araçlar için uygun değildir (salt okunur, webhook yok).
- Pro: canlı MCP server'lar için varsayılan seçenek. Tam API erişimi, webhooks, dışa aktarımlar.
- Business: uyumluluk için denetim günlüğüne ihtiyaç duyduğunuzda veya birden fazla müşteri için MCP sunucuları çalıştırıp ajan başına ekip koltuğu paylaşımı istediğinizde.