Search / io.github.vulinh1704/spend-guard
Spend Guard
L0· runs locallyBudgets, payee allowlists, price-spike checks and human approval for agents paying x402 paywalls
v0.2.0 · active · repository · website · descriptor JSON · versions
Search / io.github.vulinh1704/spend-guard
L0· runs locallyBudgets, payee allowlists, price-spike checks and human approval for agents paying x402 paywalls
v0.2.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"spend-guard": {
"command": "npx",
"args": [
"-y",
"@vulinh1704/[email protected]",
"mcp"
],
"env": {
"SPEND_GUARD_RAILS": "mock",
"SPEND_GUARD_DASHBOARD_PORT": "4400",
"SPEND_GUARD_APPROVAL_TIMEOUT": "55",
"SPEND_GUARD_MOCK_NETWORK": "near-testnet",
"ARC_PRIVATE_KEY": "${ARC_PRIVATE_KEY}",
"NEAR_PRIVATE_KEY": "${NEAR_PRIVATE_KEY}"
}
}
}
}claude mcp add spend-guard -e "SPEND_GUARD_RAILS=mock" -e "SPEND_GUARD_DASHBOARD_PORT=4400" -e "SPEND_GUARD_APPROVAL_TIMEOUT=55" -e "SPEND_GUARD_MOCK_NETWORK=near-testnet" -e "ARC_PRIVATE_KEY=${ARC_PRIVATE_KEY}" -e "NEAR_PRIVATE_KEY=${NEAR_PRIVATE_KEY}" -- npx -y @vulinh1704/[email protected] mcp[mcp_servers.spend-guard]
command = "npx"
args = ["-y", "@vulinh1704/[email protected]", "mcp"]
env = { "SPEND_GUARD_RAILS" = "mock", "SPEND_GUARD_DASHBOARD_PORT" = "4400", "SPEND_GUARD_APPROVAL_TIMEOUT" = "55", "SPEND_GUARD_MOCK_NETWORK" = "near-testnet", "ARC_PRIVATE_KEY" = "${ARC_PRIVATE_KEY}", "NEAR_PRIVATE_KEY" = "${NEAR_PRIVATE_KEY}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"spend-guard": {
"type": "local",
"command": [
"npx",
"-y",
"@vulinh1704/[email protected]",
"mcp"
],
"enabled": true,
"environment": {
"SPEND_GUARD_RAILS": "mock",
"SPEND_GUARD_DASHBOARD_PORT": "4400",
"SPEND_GUARD_APPROVAL_TIMEOUT": "55",
"SPEND_GUARD_MOCK_NETWORK": "near-testnet",
"ARC_PRIVATE_KEY": "{env:ARC_PRIVATE_KEY}",
"NEAR_PRIVATE_KEY": "{env:NEAR_PRIVATE_KEY}"
}
}
}
}{
"mcpServers": {
"spend-guard": {
"command": "npx",
"args": [
"-y",
"@vulinh1704/[email protected]",
"mcp"
],
"env": {
"SPEND_GUARD_RAILS": "mock",
"SPEND_GUARD_DASHBOARD_PORT": "4400",
"SPEND_GUARD_APPROVAL_TIMEOUT": "55",
"SPEND_GUARD_MOCK_NETWORK": "near-testnet",
"ARC_PRIVATE_KEY": "${ARC_PRIVATE_KEY}",
"NEAR_PRIVATE_KEY": "${NEAR_PRIVATE_KEY}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=spend-guard&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB2dWxpbmgxNzA0L3NwZW5kLWd1YXJkQDAuMi4wIiwibWNwIl0sImVudiI6eyJTUEVORF9HVUFSRF9SQUlMUyI6Im1vY2siLCJTUEVORF9HVUFSRF9EQVNIQk9BUkRfUE9SVCI6IjQ0MDAiLCJTUEVORF9HVUFSRF9BUFBST1ZBTF9USU1FT1VUIjoiNTUiLCJTUEVORF9HVUFSRF9NT0NLX05FVFdPUksiOiJuZWFyLXRlc3RuZXQiLCJBUkNfUFJJVkFURV9LRVkiOiIke0FSQ19QUklWQVRFX0tFWX0iLCJORUFSX1BSSVZBVEVfS0VZIjoiJHtORUFSX1BSSVZBVEVfS0VZfSJ9fQ%3D%3D"
}{
"servers": {
"spend-guard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vulinh1704/[email protected]",
"mcp"
],
"env": {
"SPEND_GUARD_RAILS": "mock",
"SPEND_GUARD_DASHBOARD_PORT": "4400",
"SPEND_GUARD_APPROVAL_TIMEOUT": "55",
"SPEND_GUARD_MOCK_NETWORK": "near-testnet",
"ARC_PRIVATE_KEY": "${ARC_PRIVATE_KEY}",
"NEAR_PRIVATE_KEY": "${NEAR_PRIVATE_KEY}"
}
}
}
}{
"mcpServers": {
"spend-guard": {
"command": "npx",
"args": [
"-y",
"@vulinh1704/[email protected]",
"mcp"
],
"env": {
"SPEND_GUARD_RAILS": "mock",
"SPEND_GUARD_DASHBOARD_PORT": "4400",
"SPEND_GUARD_APPROVAL_TIMEOUT": "55",
"SPEND_GUARD_MOCK_NETWORK": "near-testnet",
"ARC_PRIVATE_KEY": "${ARC_PRIVATE_KEY}",
"NEAR_PRIVATE_KEY": "${NEAR_PRIVATE_KEY}"
}
}
}
}extensions:
"spend-guard":
enabled: true
name: "spend-guard"
type: stdio
cmd: "npx"
args:
- "-y"
- "@vulinh1704/[email protected]"
- "mcp"
envs:
"SPEND_GUARD_RAILS": "mock"
"SPEND_GUARD_DASHBOARD_PORT": "4400"
"SPEND_GUARD_APPROVAL_TIMEOUT": "55"
"SPEND_GUARD_MOCK_NETWORK": "near-testnet"
"ARC_PRIVATE_KEY": "${ARC_PRIVATE_KEY}"
"NEAR_PRIVATE_KEY": "${NEAR_PRIVATE_KEY}"
timeout: 300
Placeholders to fill from your own secret store: ${ARC_PRIVATE_KEY}, ${NEAR_PRIVATE_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlauth.prm, auth.as_metadata, auth.cimdauth.secret_in_urltools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dump, tools.hidden_textstability.changes, stability.rug_pull, stability.new_linksdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-14d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@vulinh1704/[email protected] npmthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@vulinh1704/spend-guard | npm | 0.2.0 | npx | ARC_PRIVATE_KEY, NEAR_PRIVATE_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.vulinh1704/spend-guard",
"title": "Spend Guard",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.2.0",
"packages": [
{
"version": "0.2.0",
"transport": {
"type": "stdio"
},
"identifier": "@vulinh1704/spend-guard",
"runtimeHint": "npx",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"packageArguments": [
{
"type": "positional",
"value": "mcp"
}
],
"environmentVariables": [
{
"name": "SPEND_GUARD_POLICY",
"format": "filepath",
"description": "Policy JSON file: networks, budgets, approval amount, spike ratio, known services and their payees. Without one, every payment waits for your approval."
},
{
"name": "SPEND_GUARD_RAILS",
"default": "mock",
"description": "How to pay: mock (pays nothing), near, arc, gateway, or a comma list. arc and gateway need ARC_PRIVATE_KEY, near needs NEAR_ACCOUNT_ID and NEAR_PRIVATE_KEY."
},
{
"name": "SPEND_GUARD_LEDGER",
"format": "filepath",
"description": "Decisions file, read back on start so a restart keeps today's spend; servers on one file share one budget. Default ~/.spend-guard/ledger.jsonl; off keeps it in memory."
},
{
"name": "SPEND_GUARD_DASHBOARD_PORT",
"default": "4400",
"description": "Port of the approval dashboard on 127.0.0.1. 0 picks a free one; off means no dashboard, and payments that need approval are declined."
},
{
"name": "SPEND_GUARD_APPROVAL_TIMEOUT",
"format": "number",
"default": "55",
"description": "Seconds a payment waits for your answer before it is declined. Raise it together with your client's tool timeout."
},
{
"name": "SPEND_GUARD_MOCK_NETWORK",
"default": "near-testnet",
"description": "Network the mock rail pretends to pay on."
},
{
"name": "ARC_PRIVATE_KEY",
"isSecret": true,
"description": "Agent key for the arc and gateway rails. Testnet keys only."
},
{
"name": "NEAR_ACCOUNT_ID",
"description": "Agent account for the near rail (testnet)."
},
{
"name": "NEAR_PRIVATE_KEY",
"isSecret": true,
"description": "Agent key for the near rail. Testnet keys only."
}
]
}
],
"repository": {
"url": "https://github.com/vulinh1704/spend-guard",
"source": "github"
},
"websiteUrl": "https://github.com/vulinh1704/spend-guard#readme",
"description": "Budgets, payee allowlists, price-spike checks and human approval for agents paying x402 paywalls"
}