Audifact
Signed, append-only receipts of an AI agent's decisions and outcomes, with public proof links.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http audifact 'https://api.audifact.io/mcp' --header 'X-API-Key: <Audifact API key (af_...) from audifact.io Dashboard -> API Keys. Events bill to this key'\''s account.>'
{
"mcpServers": {
"audifact": {
"type": "http",
"url": "https://api.audifact.io/mcp",
"headers": {
"X-API-Key": "<Audifact API key (af_...) from audifact.io Dashboard -> API Keys. Events bill to this key's account.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Audifact 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؟
Signed, append-only receipts of an AI agent's decisions and outcomes, with public proof links.
كيف أثبّت Audifact؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http audifact 'https://api.audifact.io/mcp' --header 'X-API-Key: <Audifact API key (af_...) from audifact.io Dashboard -> API Keys. Events bill to this key'\''s account.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Audifact إلى مفتاح API؟
نعم. يتطلب X-API-Key، وتضبطها في إعداداته.
هل Audifact مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Audifact؟
ينشره audifact. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.