AgentGuard MCP Server
by merchantguardio.github.MerchantGuard/agentguardv0.3.1
Local spend caps, kill-switch blocking and Ed25519-signed receipts for AI agent tool calls.
context tax
queued
security
queued
cold start
queued
freshness
Active3d ago
Install AgentGuard MCP server
Install in Claude Code
claude mcp add agentguard-run -e AGENTGUARD_LICENSE_KEY='<agentguard-license-key>' -- npx -y @agentguard-run/mcpInstall in Cursor
{
"mcpServers": {
"agentguard-run": {
"command": "npx",
"args": [
"-y",
"@agentguard-run/mcp"
],
"env": {
"AGENTGUARD_LICENSE_KEY": "<agentguard-license-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"agentguard-run": {
"command": "npx",
"args": [
"-y",
"@agentguard-run/mcp"
],
"env": {
"AGENTGUARD_LICENSE_KEY": "<agentguard-license-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"agentguard-run": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentguard-run/mcp"
],
"env": {
"AGENTGUARD_LICENSE_KEY": "<agentguard-license-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"agentguard-run": {
"command": "npx",
"args": [
"-y",
"@agentguard-run/mcp"
],
"env": {
"AGENTGUARD_LICENSE_KEY": "<agentguard-license-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| AGENTGUARD_MCP_DAILY_CAP_CENTS | — | — | Local daily spend cap in cents. A nonnegative integer. |
| AGENTGUARD_MCP_PER_CALL_CAP_CENTS | — | — | Local per-call spend cap in cents. A nonnegative integer. |
| AGENTGUARD_MCP_TENANT | — | — | Tenant identifier stamped into local receipts. |
| AGENTGUARD_HOME | — | — | Local signing-key, configuration and ledger directory. Defaults to .agentguard in the operating system home directory. |
| AGENTGUARD_MCP_LEDGER | — | — | Local decision storage. ndjson persists receipts across restarts; memory retains this process only. |
| AGENTGUARD_MCP_DISABLE_COST_OVERRIDE | — | — | Set to 1 to discard and prevent model pricing overrides for this server. |
| AGENTGUARD_LOCK_COST_OVERRIDES | — | — | Spend SDK startup lock. Set to 1 to prevent model pricing overrides. |
| AGENTGUARD_ACTOR_DIGEST | — | — | Set to 1 to hash actor identifiers before they enter local receipts. |
| AGENTGUARD_LICENSE_KEY | — | yes | Optional AgentGuard license key for license validation and seat registration. Otherwise read from local configuration. |
| AGENTGUARD_LICENSE_ENDPOINT | — | — | License and seat service base URL. No prompts, tool content or receipts are sent. |
| AGENTGUARD_NO_BEACON | — | — | Set to 1 to disable optional activation telemetry regardless of saved consent. |
| AGENTGUARD_TELEMETRY | — | — | Set to 1 to opt in to content-free activation telemetry. Otherwise saved consent applies, default off. |
| AGENTGUARD_INSTALL_ID | — | — | Optional identifier used only by opted-in activation telemetry when no saved install identifier exists. |
| AGENTGUARD_ANONYMOUS_INSTALL_ID | — | — | Legacy fallback for AGENTGUARD_INSTALL_ID in opted-in activation telemetry. |
| CI | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| GITHUB_ACTIONS | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| GITLAB_CI | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| CIRCLECI | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| BUILDKITE | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| VERCEL | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
| NETLIFY | — | — | Existing runtime marker. A nonempty value marks opted-in activation telemetry as CI; it does not enable telemetry. |
Freshness
Active — last maintenance signal 3d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-21 · 19d ago · official registry · v0.3.1
FAQ
›How do I install the AgentGuard MCP server in Claude Code?
Run: claude mcp add agentguard-run -e AGENTGUARD_LICENSE_KEY='<agentguard-license-key>' -- npx -y @agentguard-run/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does AgentGuard require an API key?
Yes. It expects AGENTGUARD_LICENSE_KEY, of which 1 is a secret.
›Can I use AgentGuard as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is AgentGuard in the official MCP registry?
Yes, as io.github.MerchantGuard/agentguard.