PayStage MCP란?
로컬 규칙에 따라 트랜잭션을 평가하여 결제 승인, 검토 요청 또는 거부 결정을 내림으로써 AI agent 결제에 대한 안전 정책을 강제합니다. 5개 도구를 제공합니다. 예: evaluate_mcp_payment, list_outstanding_auths, evaluate_outstanding_auths.
프로젝트 README에서 생성된 요약
PayStage MCP server 정보
PayStage는 agent와 지갑 사이의 게이트키퍼 역할을 수행하여 AI agent 금융 트랜잭션에 대한 안전 계층을 제공합니다. 제안된 결제를 로컬 정책 파일과 대조하여 트랜잭션을 승인할지, 사람의 검토를 거칠지, 또는 완전히 거부할지를 결정합니다. 이 server는 제어된 지출 한도와 보안 가드레일이 필요한 자율 agent를 구축하는 개발자를 위해 설계되었습니다.
server는 stdio를 통해 실행되며 Claude Desktop 또는 Cursor에 통합할 수 있습니다. 사용자는 PAYSTAGE_POLICY_PATH 환경 변수를 통해 로컬 policy.json 파일의 경로를 제공해야 합니다. 또한 온체인 확인을 위한 선택 사항인 PAYSTAGE_RPC_URL을 지원하며, 기본값은 공개 Base RPC입니다. 통합 server에는 트랜잭션 안전의 다양한 측면을 관리하기 위한 5가지 특정 도구가 포함되어 있습니다.
주요 기능에는 x402 결제 평가, evaluate_hip3_trade를 통한 거래 주문 확인, evaluate_velocity를 이용한 지출 패턴 모니터링이 포함됩니다. 또한 이중 결제 위험을 방지하기 위해 미결제 승인 내역을 나열하고 평가하는 도구도 제공합니다.
활용 사례
- 1트랜잭션 안전 한도 강제AI agent는 자금을 이동하기 전에 제안된 x402 결제가 로컬 보안 규칙을 준수하는지 확인할 수 있습니다.
- 2agent 지출 속도 모니터링개발자는 server를 사용하여 agent가 특정 속도 또는 지출 패턴 임계값을 초과하지 않도록 보장할 수 있습니다.
- 3HIP-3 거래 주문 검증자율 트레이더는 특정 거래 주문이 로컬 정책에 정의된 안전 기준을 충족하는지 확인할 수 있습니다.
- 4이중 결제 위험 방지시스템은 승인되었으나 정산되지 않은 결제를 감사하여 잠재적인 미결제 또는 중복 결제 위험을 식별할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
PayStage MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 PayStage MCP 설치
$ claude mcp add paystage -- npx -y @paystage/mcpCursor에 PayStage MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}VS Code에 PayStage MCP 설치
.vscode/mcp.json
{
"servers": {
"paystage": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}VS Code CLI에 PayStage MCP 설치
$ code --add-mcp '{"name":"paystage","type":"stdio","command":"npx","args":["-y","@paystage/mcp"]}'Claude Desktop에 PayStage MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}Codex에 PayStage MCP 설치
$ codex mcp add paystage -- npx -y @paystage/mcpCodex config.toml에 PayStage MCP 설치
~/.codex/config.toml
[mcp_servers.paystage] command = "npx" args = ["-y", "@paystage/mcp"]
Gemini CLI에 PayStage MCP 설치
$ gemini mcp add -s user paystage npx -- -y @paystage/mcpGemini settings.json에 PayStage MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"paystage": {
"command": "npx",
"args": [
"-y",
"@paystage/mcp"
]
}
}
}PayStage MCP 도구 5
README에서 감지됨evaluate_mcp_paymentlist_outstanding_authsevaluate_outstanding_authsevaluate_hip3_tradeevaluate_velocity
| evaluate_mcp_payment | — | |
| list_outstanding_auths | — | |
| evaluate_outstanding_auths | — | |
| evaluate_hip3_trade | — | |
| evaluate_velocity | — |
구성
PAYSTAGE_POLICY_PATHPAYSTAGE_RPC_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| PAYSTAGE_POLICY_PATH | — | |
| PAYSTAGE_RPC_URL | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기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 질문
PayStage MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add paystage -- npx -y @paystage/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
PayStage MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
PayStage MCP는 어떤 도구를 제공하나요?
5개 도구를 제공합니다. 예: evaluate_mcp_payment, list_outstanding_auths, evaluate_outstanding_auths, evaluate_hip3_trade, evaluate_velocity.
PayStage는 무엇을 하나요?
PayStage는 AI agent 지갑을 위한 안전 계층 역할을 하며, 로컬 정책을 기반으로 제안된 결제를 진행할지, 사람의 검토가 필요할지, 또는 거부할지를 결정합니다.
결제 동작은 어떻게 제어되나요?
모든 결제 결정은 다양한 agent 유형에 대한 규칙을 정의하는 단일 로컬 정책 파일에 의해 관리됩니다.
서버에 RPC endpoint가 필요한가요?
네, 온체인 확인을 위해 RPC endpoint를 사용하며, 별도로 지정하지 않으면 기본적으로 공개 Base RPC를 사용합니다.