io.github.datumline/agent-guard
OfficialProvides a LangChain tool, AgentGuardTool (agent_guard_verify), that verifies completion claims from manifests and returns a JSON receipt; only a VERIFIED verdict indicates success.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.datumline/agent-guard Verify my agent's completion claim against out/manifest.json"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
datumline-agent-guard
An independent verifier for AI agent work. An agent says a job is COMPLETED; agent-guard checks the artifacts it claims to have produced and returns a verdict. A completion claim with a missing artifact is reported as FALSE_DONE, not as a pass.
Standard library only, no dependencies. It imports nothing from the runtime it audits, so it can contradict that runtime.
Install
pip install datumline-agent-guardRelated MCP server: VerifyAPI MCP Server
CLI
agent-guard manifest.json # human-readable receipt
agent-guard manifest.json --json # machine-readable receiptExit code is 0 only on VERIFIED; every other verdict exits 1 (bad input exits 2), so it can gate CI or an agent loop.
Manifest
{
"job": "WO-123",
"claimed_status": "COMPLETED",
"artifacts": [
{"type": "file", "path": "out/report.md", "min_bytes": 200, "must_contain": ["## Findings"]},
{"type": "json", "path": "out/feed.json", "required_keys": ["last_marked", "entries"]},
{"type": "url", "url": "https://example.com/feed.json", "status": 200, "must_contain": ["last_marked"]},
{"type": "file", "path": "out/data.parquet", "sha256": "<hex>"}
]
}Relative paths resolve against the current working directory.
Verdicts
Verdict | Meaning |
| every artifact is present and passes every check |
| an artifact is present but fails a check, or is absent without a completion claim |
|
|
| the manifest asserts no artifacts; fail-closed, never green |
Library
from datumline_agent_guard import verify, verify_file
receipt = verify({"claimed_status": "COMPLETED", "artifacts": [{"type": "file", "path": "out/report.md"}]})
if receipt["verdict"] != "VERIFIED":
raise SystemExit(receipt["verdict"])GitHub Action
Fail a workflow when an agent's "done" doesn't check out:
- uses: datumline/datumline-agent-guard@v0.2.0
with:
manifest: agent-output/manifest.json # what the agent claims it produced
# fail-on: false-done # only fail on FALSE_DONE (default: anything but VERIFIED)The step installs this package from the action's own source (no network fetch), writes the receipt to the job summary, sets the verdict and receipt outputs, and exits non-zero unless the verdict is VERIFIED. It needs python3 3.9+ on the runner, which GitHub-hosted runners have.
MCP server
The same verifier as an MCP tool, verify_completion_claim, for Claude, ChatGPT, Copilot, Cursor or any MCP client. Standard library only, stdio transport.
{
"mcpServers": {
"agent-guard": { "command": "uvx", "args": ["datumline-agent-guard"] }
}
}Or pip install datumline-agent-guard and run datumline-agent-guard (alias agent-guard-mcp). The tool takes manifest (object) or manifest_path (string) and returns the receipt; anything other than "verdict": "VERIFIED" means not done. It reads the files and fetches the URLs the manifest names, and sends nothing anywhere else.
LangChain
pip install "datumline-agent-guard[langchain]"from datumline_agent_guard.langchain_tool import AgentGuardTool
tool = AgentGuardTool() # name: agent_guard_verify
tool.invoke({"manifest": {"claimed_status": "COMPLETED", "artifacts": [{"type": "file", "path": "out/report.md"}]}})
# -> JSON receipt; anything other than "verdict": "VERIFIED" means not doneGive it to an agent as a tool, or call it yourself before accepting the agent's "done". It also takes manifest_path instead of manifest. It passes LangChain's standard tool tests (langchain-tests). Requires Python 3.10+; the core package needs only 3.9 and has no dependencies.
Related
The same verifier ships inside the free, MIT-licensed Receipted Operator Claude Code plugin, which adds a receipt ledger, truthful statuses and a hook that refuses unreceipted "done". Datumline also publishes paid method kits at datumlinehq.gumroad.com.
License
MIT
Available Tools
1 toolverify_completion_claimVerify an agent's completion claimARead-only
Check an AI agent's claim that a job is done against the artifacts it says it produced. Returns a JSON receipt whose 'verdict' is VERIFIED (every artifact present and passing), FAILED (an artifact fails a check), FALSE_DONE (the job is claimed COMPLETED/DONE but an artifact is missing) or UNVERIFIABLE (the manifest names no artifacts). Treat anything other than VERIFIED as not done. Artifact types: file (path, min_bytes, min_lines, must_contain, sha256), json (path, required_keys), url (url, status, must_contain). Relative paths resolve against the server's working directory.
Inputs: manifest, manifest_path.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of selecting the wrong tool or confusing it with another operation. Its purpose is clearly scoped to verifying an agent's completion claim against artifacts.
The single tool name follows a clear verb_noun convention: verify_completion_claim. With only one tool there are no conflicting naming styles or inconsistent patterns.
The server has a very narrow purpose, so one focused tool is defensible, but a single-tool surface is thin for an MCP server. It lacks companion operations such as listing or retrieving prior verification receipts.
The tool covers several artifact types and clear verdicts, which addresses the core verification workflow well. Minor gaps remain around receipt retrieval, history, or manifest management, but agents can work around them.
Maintenance
Related MCP Connectors
One-stop claim verification for AI agents: verdicts with confidence, evidence, signed receipts.
Verify AI work against criteria and get signed receipts. From Spoolis, guarantees for AI work.
Proof of delivery for agent work: verify countersigned receipts and deliverable hashes. Free.
Check claims against a fact-store: consistent, contradicts, or unverifiable — with a receipt.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables verification of AI agent identity, authority, and integrity at transaction time, returning signed verdicts for allow, step-up, review, or block.MIT
- AlicenseAqualityCmaintenanceEnables agents and clients to fact-check factual claims against live web sources, returning citable verdicts with source details and cryptographically signed receipts for downstream verification.1102 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to verify claims against evidence through MCP tools, returning approved, rejected, or needs_review verdicts with replayable receipts.MIT
- AlicenseNot gradedqualityBmaintenanceEnables deterministic verification of AI agent decisions and actions, providing PASS/FAIL/ABSTAIN verdicts with replayable proofs and an optional signed receipt ledger.4 npmApache 2.0