İşlemleri yerel kurallara göre değerlendirerek ödeme yap, incelemeye gönder veya reddet kararları döndüren ve yapay zeka ajanı ödemeleri için güvenlik politikalarını uygulayan bir sistemdir.
Ayrıca bilinen adı base-buzz/paystage, @paystage/mcp
- Yıldızlar
- 5
- Araçlar
- 5
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 16 Kas 2026
- Lisans
- MIT
PayStage MCP nedir?
İşlemleri yerel kurallara göre değerlendirerek ödeme yap, incelemeye gönder veya reddet kararları döndüren ve yapay zeka ajanı ödemeleri için güvenlik politikalarını uygulayan bir sistemdir. 5 araç sunar; örneğin evaluate_mcp_payment, list_outstanding_auths, evaluate_outstanding_auths.
Özet, projenin README dosyasından oluşturuldu
PayStage MCP sunucusu hakkında
PayStage, bir ajan ile cüzdanı arasında bir kapı bekçisi görevi görerek yapay zeka ajanı finansal işlemleri için bir güvenlik katmanı sağlar. Önerilen ödemeleri yerel bir politika dosyasına göre değerlendirerek işlemin onaylanıp onaylanmayacağını, insan incelemesine gönderilip gönderilmeyeceğini veya tamamen reddedilip edilmeyeceğini belirler. Bu sunucu, kontrollü harcama limitleri ve güvenlik bariyerleri gerektiren otonom ajanlar geliştiren yazılımcılar için tasarlanmıştır.
Sunucu stdio üzerinden çalışır ve Claude Desktop veya Cursor içine entegre edilebilir. Kullanıcıların PAYSTAGE_POLICY_PATH ortam değişkeni aracılığıyla yerel bir policy.json dosyasına yol göstermeleri gerekir. Ayrıca, zincir üstü kontroller için varsayılan olarak halka açık bir Base RPC kullanan isteğe bağlı bir PAYSTAGE_RPC_URL desteği de sunar. Ana sunucu, işlem güvenliğinin farklı yönlerini yönetmek için beş özel araç içerir.
Temel yetenekler arasında x402 ödemelerini değerlendirmek, evaluate_hip3_trade aracılığıyla ticaret emirlerini kontrol etmek ve evaluate_velocity ile harcama modellerini izlemek yer alır. Ayrıca, çift ödeme risklerini önlemek için bekleyen yetkilendirmeleri listelemek ve değerlendirmek için araçlar sunar.
Neler yapabilirsiniz
- 1İşlem güvenlik limitlerini uygulayınBir yapay zeka ajanı, fonları aktarmadan önce önerilen bir x402 ödemesinin yerel güvenlik kurallarına uygun olup olmadığını kontrol edebilir.
- 2Ajan harcama hızını izleyinBir geliştirici, bir ajanın belirli hız veya harcama modeli eşiklerini aşmamasını sağlamak için sunucuyu kullanabilir.
- 3HIP-3 ticaret emirlerini doğrulayınOtonom bir yatırımcı, belirli bir ticaret emrinin yerel bir politikadaki önceden tanımlanmış güvenlik kriterlerini karşılayıp karşılamadığını doğrulayabilir.
- 4Çift ödeme risklerini önleyinSistem, potansiyel askıda kalma veya mükerrer ödeme risklerini belirlemek için yetkilendirilmiş ancak henüz sonuçlanmamış ödemeleri denetleyebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
PayStage MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklePayStage MCP'yi Claude Code içine yükleyin
$ claude mcp add paystage -- npx -y @paystage/mcpPayStage MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}PayStage MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"paystage": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}PayStage MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"paystage","type":"stdio","command":"npx","args":["-y","@paystage/mcp"]}'PayStage MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}PayStage MCP'yi Codex içine yükleyin
$ codex mcp add paystage -- npx -y @paystage/mcpPayStage MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.paystage] command = "npx" args = ["-y", "@paystage/mcp"]
PayStage MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user paystage npx -- -y @paystage/mcpPayStage MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}PayStage MCP araçları 5
README dosyasından algılandıevaluate_mcp_paymentlist_outstanding_authsevaluate_outstanding_authsevaluate_hip3_tradeevaluate_velocity
| evaluate_mcp_payment | — | |
| list_outstanding_auths | — | |
| evaluate_outstanding_auths | — | |
| evaluate_hip3_trade | — | |
| evaluate_velocity | — |
Yapılandırma
PAYSTAGE_POLICY_PATHPAYSTAGE_RPC_URL
| Ad | Açıklama | Sunucu |
|---|---|---|
| PAYSTAGE_POLICY_PATH | — | |
| PAYSTAGE_RPC_URL | — |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
PayStage
Your agent's wallet should not sign because a server asked it to.
PayStage sits between an agent and the x402 payment it is about to make, and answers one
question before the signature exists: should this payment happen? Every tool returns
pay, review, or do_not_pay, with the rule that fired and a receipt you can keep.
The gap it fills is narrow and load-bearing. x402 makes paying trivial and leaves deciding
to the caller: a wallet enforces signatures, not intent. @paystage/x402-guard evaluates the
challenge before the wallet signs, so a wrong payee, an over-cap amount or an unknown asset
never reaches the signing step at all.
Try it without installing anything:
curl -s -X POST https://api.paystage.xyz/v1/evaluate_mcp_payment \
-H 'content-type: application/json' \
-d '{"payment_required":{…},"policy":{…}}'
The hosted endpoint serves a real verdict with no payment and no account for the first 1,000 calls per IP per day — an agent cannot fill in a signup form, so requiring one would exclude exactly the callers this is built for.
Quick start
# Option 1: run instantly
npx -y -p @paystage/mcp paystage-mcp
# Option 2: install locally, then use the package bin
npm install @paystage/mcp
npx paystage-mcp
The server waits silently for an agent app to connect. That's normal; press Ctrl+C to exit. To try the tools without an app, run npx @modelcontextprotocol/inspector npx -y -p @paystage/mcp paystage-mcp.
@paystage/mcp is the umbrella MCP server (5 tools, including evaluate_hip3_trade and evaluate_velocity). It exposes the PayStage tools over stdio and reads a local policy file. See SECURITY.md for exactly what it accesses and why.
Four ways in
| You want | Use |
|---|---|
| the gate inside an agent's payment loop | @paystage/x402-guard |
| the tools in Claude Desktop or Cursor | @paystage/mcp |
| a verdict from your own service, hosting included | POST https://api.paystage.xyz/v1/evaluate_mcp_payment |
| the evaluator as a library | @paystage/preflight |
Listed on
Configure
The same MCP config works for Claude Desktop (claude_desktop_config.json) and Cursor (.cursor/mcp.json).
Using npx
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": ["-y", "@paystage/mcp"],
"env": {
"PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json",
"PAYSTAGE_RPC_URL": "https://mainnet.base.org"
}
}
}
}
Using a local npm install
{
"mcpServers": {
"paystage": {
"command": "node",
"args": ["./node_modules/@paystage/mcp/dist/cli.js"],
"env": {
"PAYSTAGE_POLICY_PATH": "/absolute/path/to/policy.json",
"PAYSTAGE_RPC_URL": "https://mainnet.base.org"
}
}
}
}
PAYSTAGE_POLICY_PATH(required): path to your localpolicy.json.PAYSTAGE_RPC_URL(optional): RPC endpoint used by on-chain checks. Defaults to a public Base RPC.
Policies
Everything PayStage does is decided by one local policy file. Three complete, annotated
examples are in registry/examples/ — copy one, change the
addresses and amounts, and point PAYSTAGE_POLICY_PATH at it. Each is schema-exact for
@paystage/policy and annotated field by field in
registry/examples/README.md.
- Reader bot — reads articles and search results; 0.05 USDC per call, unknown payees denied.
- Trading bot — places HIP-3 orders; per-agent budgets, velocity windows and human review above 10 USDC.
- Research agent — discovers data endpoints; unknown payees go to review, never an unattended pay.
Tools
| Tool | Status | What it does |
|---|---|---|
evaluate_mcp_payment |
Available now | Evaluates a proposed x402 payment against the local policy and returns pay, review, or do_not_pay. |
list_outstanding_auths |
Available now | Lists payments that are authorized but not yet settled. |
evaluate_outstanding_auths |
Available now | Evaluates outstanding authorizations and flags double-pay or limbo risk. |
evaluate_hip3_trade |
Available now | Evaluates a proposed HIP-3 / trade.xyz order against a local TradePolicy (allow | review | do_not_trade). Not financial advice — local policy gate only. |
evaluate_velocity |
Available now | Rate and spend-pattern velocity checks against the local policy. |
Packages
| Package | Role | Links |
|---|---|---|
@paystage/mcp |
Umbrella MCP server (start here) | npm |
@paystage/preflight |
MCP payment preflight | npm |
@paystage/auth-watch |
Outstanding-auth watch | npm |
@paystage/policy |
Policy parsing and evaluation | npm |
@paystage/trade-preflight |
HIP-3 / trade.xyz trade preflight | npm |
Verify it yourself
Every claim this project makes about itself is reducible to a command. Run it before you trust anything on the website:
node apps/hosted/scripts/conformance.mjs
It checks the published surfaces against reality — manifest shape, the five tools being listed, machine surfaces being genuinely different from each other, health and timing headers on both networks, the receipt key endpoint, that an unpaid evaluation is challenge-only, and that malformed input fails closed. Read-only: no payment, no key, no account. Exit code 1 if anything is off.
It runs daily in CI (cadence.yml) and the result history is on the site.
Supply chain
Socket.dev scores packages on capability, so a payment-safety tool will always carry
flags: it reads a policy file, reads two environment variables and talks to an RPC.
Every package README states exactly what it touches and why, and
SECURITY.md has the full table. The umbrella @paystage/mcp is ~16 KB
with no network, no filesystem and no eval of its own — the capability lives in the
tools it bundles.
Links
- Website: https://paystage.xyz
- X: https://x.com/paystage_xyz
- GitHub: https://github.com/base-buzz/paystage
- npm: https://www.npmjs.com/org/paystage
- Machine-readable: https://paystage.xyz/llms.txt
Development
This is a monorepo.
pnpm install
pnpm build
pnpm test
pnpm lint
Contributing
PayStage is built in the open, and outside contributions are welcome.
- Add a drainer address. Open a PR adding it to
KNOWN_DRAINERS.mdwith a public source link (incident report, explorer label, or security write-up). Unsourced addresses won't be merged. - Add an integration example. LangChain, AgentKit, ElizaOS and others are all welcome.
- Report a bypass. If an unsafe payment gets past preflight, open an issue. That's the most valuable contribution there is.
Look for issues labelled good first issue to get started.
License
MIT
PayStage MCP soruları
PayStage MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add paystage -- npx -y @paystage/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
PayStage MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
PayStage MCP hangi araçları sunar?
5 araç sunar; bunlar arasında evaluate_mcp_payment, list_outstanding_auths, evaluate_outstanding_auths, evaluate_hip3_trade, evaluate_velocity yer alır.
PayStage ne yapar?
PayStage, bir yapay zeka ajanı cüzdanı için güvenlik katmanı görevi görür; önerilen bir ödemenin yerel bir politikaya dayanarak devam edip etmeyeceğine, insan incelemesi gerektirip gerekmeyeceğine veya reddedilip edilmeyeceğine karar verir.
Ödeme davranışı nasıl kontrol edilir?
Tüm ödeme kararları, farklı ajan türleri için kuralları tanımlayan tek bir yerel politika dosyası tarafından yönetilir.
Sunucu bir RPC endpoint gerektirir mi?
Evet, zincir üstü kontroller için bir RPC endpoint kullanır; belirtilmediği takdirde varsayılan olarak halka açık bir Base RPC kullanılır.