agent-custody
Gateway that checks agent tool calls against signed grants and records signed receipts
- Pricing
- Freemium
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 0.16.6
- Listing updated
- 3 days ago
About agent-custody
agent-custody is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.
The idea is a tamper-evident trail for what an AI agent actually did. A hook sits between the agent and its tools, checks each shell command, file edit or MCP call against a policy written as deny rules, and writes a signed receipt whose hash goes into an append-only log. Anyone holding the public keys can verify a receipt offline.
One command sets up a key, a starter deny list and Claude Code hooks for the current directory. It begins in observe mode, so nothing is blocked until you remove one line from the config. An audit-sessions command reads your past Claude Code transcripts and reports which calls the starter list would have caught, writing nothing. The site's own example shows force pushes and terraform destroy being flagged.
The gateway, SDK, ledger and verifier are Apache-2.0 and free to run yourself. What is priced is a hosted log run by a third party, so outsiders can trust the record. It needs Node 22.
Install
Run in a terminal
claude mcp add agent-custody -- npx -y @agent-custody/receiptsAdd to claude_desktop_config.json
{
"mcpServers": {
"agent-custody": {
"command": "npx",
"args": [
"-y",
"@agent-custody/receipts"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-custody": {
"command": "npx",
"args": [
"-y",
"@agent-custody/receipts"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agent-custody": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agent-custody/receipts"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agent-custody": {
"command": "npx",
"args": [
"-y",
"@agent-custody/receipts"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agent-custody": {
"command": "npx",
"args": [
"-y",
"@agent-custody/receipts"
]
}
}
}What it does
- Signed receipts
- Each call produces a receipt that can be verified offline with public keys.
- Deny-list policy
- Rules written as policies block calls such as force pushes or terraform destroy.
- Observe mode first
- Starts by recording only, so you can see what would be denied.
- Transcript audit
- Replays past Claude Code sessions against the policy without writing anything.
- Tamper-evident log
- Receipt hashes land in a log that others can check.
- Hosted log option
- A paid, third-party-run log lets outsiders accept your records.
Good for
- Prove to a reviewer which commands an agent ran
- Block destructive commands like force pushes before they execute
- Find out what a deny list would have caught in last week's sessions
- Give auditors verifiable records of agent activity
Pricing
Freemium, from $50 a month
Self-run parts free (Apache-2.0); hosted log Free or Team at $50/mo
Prices change. Check agent-custody.dev before you buy.
agent-custody FAQ
Does it block anything straight away?
No. It starts in observe mode and blocks only after you remove the observe setting.
Can I verify receipts without the vendor?
Yes. Anyone with the public keys can verify a receipt offline.
What does it cost?
The self-run parts are Apache-2.0 and free. The hosted log has a Free tier and a Team plan at $50 a month.
What runtime does it need?
Node 22.
Is agent-custody free?
agent-custody has a free plan, with paid plans for more usage or features. Paid plans start at $50 a month.
How do I add agent-custody to Claude Code?
Run this command in your terminal: claude mcp add agent-custody -- npx -y @agent-custody/receipts
What are the best alternatives to agent-custody?
The closest alternatives to agent-custody are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to agent-custody

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools