Audifact MCP server
Commit Oct 19, 2026Provides signed, append-only receipts of AI agent decisions and outcomes with public proof links for verifiable auditing.
Also known as audifact/audifact-plugin, audifact-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Oct 19, 2026
- License
- —
What is Audifact MCP?
Audifact provides signed, append-only receipts of AI agent decisions and outcomes with public proof links for verifiable auditing.
Summary generated from the project's README
About Audifact MCP server
Audifact provides a way for developers to create verifiable audit trails for AI agent activities. Instead of full tracing, this server focuses on generating signed, append-only receipts for consequential decisions, external actions, and subagent delegations. It is designed for low-frequency logging, targeting roughly three to ten events per active day to maintain a clear record of important outcomes.
Users connect to the remote server at api.audifact.io/mcp using an API key starting with af_ and must configure it within their specific client, such as Claude Code, Cursor, or Grok Bot. The system uses hash-chaining to ensure that once an event is logged, it cannot be edited or deleted. To protect privacy, the plugin redacts sensitive information like passwords or full file contents, recording only short summaries of the events.
Developers can manage these logs through specific tools including log_decision, log_outcome, and get_proof. The server also supports registering agents and listing recent decisions or outcomes. Every logged event consumes credits from the Audifact account associated with the provided API key.
What you can do with it
- 1Verify agent decision historyAsk the AI to provide a public proof link for a specific decision it just made.
- 2Audit consequential actionsInstruct the agent to log an external action or a delegation to a subagent for future review.
- 3Review recent agent outcomesRequest a list of all recent outcomes recorded by the agent to check its performance.
- 4Confirm secure connectionVerify that the Audifact plugin is correctly connected to the agent environment.
Written from the project's README. Every use case is checked against a quote from it.
How to install Audifact MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Audifact MCP in Claude Code
$ claude mcp add --transport http audifact-plugin https://api.audifact.io/mcpInstall Audifact MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"audifact-plugin": {
"url": "https://api.audifact.io/mcp"
}
}
}Install Audifact MCP in VS Code
.vscode/mcp.json
{
"servers": {
"audifact-plugin": {
"type": "http",
"url": "https://api.audifact.io/mcp"
}
}
}Install Audifact MCP in VS Code CLI
$ code --add-mcp '{"name":"audifact-plugin","type":"http","url":"https://api.audifact.io/mcp"}'Install Audifact MCP in Codex
$ codex mcp add audifact-plugin --url https://api.audifact.io/mcpInstall Audifact MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.audifact-plugin] url = "https://api.audifact.io/mcp"
Install Audifact MCP in Gemini CLI
$ gemini mcp add -s user --transport http audifact-plugin https://api.audifact.io/mcpInstall Audifact MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"audifact-plugin": {
"url": "https://api.audifact.io/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableaudifact/audifact-plugin is public and reachablegithub.com/audifact/audifact-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-19github.com/audifact/audifact-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 66 msPass
README
View on GitHubAudifact agent plugin
Your agent keeps a signed receipt of its decisions.
This repo packages Audifact’s hosted MCP server (https://api.audifact.io/mcp) plus a skill that tells the agent to log consequential decisions, external actions, and subagent delegations — then hand you proof links (https://audifact.io/e/{event_hash}).
It is receipts, not silent full tracing. Target about 3–10 events per active day.
Install
1. Audifact API key (all clients)
- Create an account at https://audifact.io/signup (the plugin never creates accounts).
- Dashboard → API Keys → create a key (
af_..., shown once). - Paste it only into the client’s secret / masked field. Never into chat or files.
2. Pick your client
Official MCP Registry / VS Code / Copilot / other registry clients
Listed as io.audifact/audifact in the MCP Registry (search “audifact”). Add the remote server from the registry or your client’s MCP gallery. Provide X-API-Key when prompted. Metadata: server.json.
Claude Code (self-hosted marketplace — no review queue)
/plugin marketplace add audifact/audifact-plugin
/plugin install audifact@audifact
Paste the key into Audifact API key (userConfig, stored in the OS keychain).
Grok Bot / Cursor (x.ai catalog)
Install from the catalog when listed. Paste the key into AUDIFACT_API_KEY.
(Repo renamed from grokbot-plugin → audifact-plugin; resubmit replaces the 2026-10-16 draft.)
Agent Skills only (npx skills add)
npx skills add audifact/audifact-plugin
This installs the skill instructions. You still need the MCP server connected in the same client, or the skill has no tools to call.
3. Confirm
Ask the agent to confirm the Audifact connection. It should log one plugin_connected decision and return a proof URL.
⚠️ Append-only ledger
Everything logged is signed and hash-chained and cannot be edited or deleted. The skill redacts before writing: no secrets, tokens, passwords, full message bodies or file contents — only short summaries.
Billing
Every event consumes credits on the Audifact account that owns the API key.
Privacy
- Public labels are off by default.
- Each agent logs under its own
agent_name(e.g.grokbot-cos,claude-code).
Tools
log_decision, log_outcome, get_proof, register_agent, list_agent_decisions (deprecated alias: list_my_recent_decisions), list_agent_outcomes.
Repo layout
| Path | Role |
|---|---|
.mcp.json |
Grok/Cursor: X-API-Key: ${AUDIFACT_API_KEY} |
.grok-plugin/ |
x.ai / Grok Bot plugin manifest |
.claude-plugin/ |
Claude Code marketplace + userConfig key (overrides MCP auth for Claude) |
skills/audifact/ |
Agent Skills SKILL.md |
server.json |
Official MCP Registry remote metadata |
assets/logo.svg |
Brand AF monogram |
License
MIT
Audifact MCP questions
How do I add Audifact MCP to Claude Code?
Run claude mcp add --transport http audifact-plugin https://api.audifact.io/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Audifact MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the server log sensitive information like passwords?
No, the skill redacts information before writing to ensure no secrets, tokens, passwords, or full file contents are stored.
How do I verify the connection is working?
You can ask the agent to confirm the Audifact connection; it should log a 'plugin_connected' decision and provide a proof URL.