Agentguard47
The AgentGuard47 server provides read-only access to agent trace data, guard alerts, usage metrics, and cost breakdowns for the AgentGuard runtime monitoring system.
Query trace summaries (
query_traces): Search and paginate through trace summaries, filterable by service name and time range, returning metadata like trace ID, event/error counts, duration, and cost.Get full trace details (
get_trace): Retrieve the complete event tree for a specific trace ID, including all spans, tool calls, LLM calls, guard triggers, and errors.Get trace decisions (
get_trace_decisions): Extract normalized decision events (proposals, overrides, approvals, bindings) from a trace — useful for auditing human-in-the-loop workflows.Get alerts (
get_alerts): Fetch recent guard alerts such as loop detections and budget overruns, optionally filtered by time.Check usage quota (
get_usage): View current event quota consumption versus plan limits, including retention period and plan details.Get cost breakdown (
get_costs): Retrieve the current month's cost breakdown by model, total spend, and estimated savings from guard interventions.Budget health check (
check_budget): Run a quick pass/fail assessment combining usage quota and cost data to determine if operations are within safe limits.
Provides runtime guards for CrewAI agents, including loop, retry, and budget limits via optional integration extra.
Integrates runtime guards with LangChain agents to enforce budgets, loops, and retry limits via optional extra.
Adds runtime control to LangGraph agents, including hard budget caps and loop detection via optional integration extra.
Auto-patches OpenAI SDK to trace and enforce budget limits on chat completions, stopping overspend in-process.
AgentGuard
Stop runaway agents before they burn money.
Zero-dependency Python kill switch for AI agents. Hard budget caps. Loop detection. Local traces. MIT.
pip install agentguard47Getting started
1. Install and verify
pip install agentguard47
agentguard doctor # package ok?
agentguard demo # offline proof (no API keys)2. Guard an OpenAI client
from agentguard import BudgetGuard, LoopGuard, Tracer, patch_openai
budget = BudgetGuard(max_cost_usd=5.00, warn_at_pct=0.8)
loop = LoopGuard(max_repeats=3)
tracer = Tracer(service="my-agent", guards=[loop])
patch_openai(tracer, budget_guard=budget)
# every OpenAI call is now traced + budget-enforcedWhen spend crosses the hard limit, BudgetExceeded is raised and the run stops.
3. Cap a single task
Session budget can still have headroom. One goal can still be killed:
with budget.goal("refund", max_cost_usd=0.50, warn_at_pct=0.8) as g:
g.attempt()
budget.consume(cost_usd=0.12)
# BudgetExceeded names the goal when it crosses4. Read the local proof
agentguard report .agentguard/traces.jsonl
agentguard incident .agentguard/traces.jsonlOr scaffold a starter file:
agentguard quickstart --framework raw --write
python agentguard_raw_quickstart.pyRelated MCP server: Langfuse MCP Server
What it stops
Problem | Guard | Exception |
Spend blowup |
|
|
Same tool forever |
|
|
Fuzzy / A-B-A-B loops |
|
|
Retry storms |
|
|
Hung runs |
|
|
Spam calls |
| — |
Not a dashboard. Not a model router. An in-process exception that kills the bad run mid-flight.
Features
Hard stops — exceptions inside your process, not after-the-fact alerts
Task-level budgets —
BudgetGuard.goal(...)for sub-task caps + warn hooksLocal traces — JSONL by default; no network unless you opt in
Zero deps — stdlib only; Python 3.9+
Provider patches —
patch_openai/patch_anthropicFramework hooks — LangChain, LangGraph, CrewAI (optional extras)
Local by default
No API key required for local proof
No network unless you configure
HttpSinkMIT licensed
The SDK is the free local proof path. Start local. Add hosted ingest later only if you want retained history, alerts, team visibility, spend trends, hosted decision history, or dashboard-managed remote kill signals. Local guards remain authoritative. HttpSink mirrors trace and decision events; it does not execute remote kill signals by itself.
Integrations
OpenAI · Anthropic · LangChain · LangGraph · CrewAI · raw agent loops
pip install "agentguard47[langchain]" # optional extras as neededDocs
MCP server —
npx -y @agentguard47/mcp-server
Links
MIT · Built for people who ship agents and hate surprise bills.
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bmdhodl/agent47'
If you have feedback or need assistance with the MCP directory API, please join our Discord server