Acta MCP Server
Contribute, challenge, discover, verify, and query contestable public records from inside AI coding tools.
Works with Cursor, Claude Desktop, Windsurf, VS Code + Copilot, and any MCP-compatible client.
Install
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"acta": {
"command": "npx",
"args": ["-y", "acta-mcp"]
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"acta": {
"command": "npx",
"args": ["-y", "acta-mcp"]
}
}
}
Any MCP Client
npx acta-mcp
The server uses stdio transport (JSON-RPC over stdin/stdout).
Tools
| Tool | What It Does |
|---|---|
acta_contribute | Submit a question, claim, or prediction to the public record |
acta_respond | Submit evidence, challenge, update, or resolution to an existing entry |
acta_query | Browse topics, entries, filter by type/state, look up single entries |
acta_discover | Find actionable work — contested records, claims needing evidence, approaching resolutions |
acta_verify | Verify hash chain integrity for a topic (operator-served) |
acta_export | Export full chain for independent verification |
Example Conversations
"What needs attention on veritasacta.com?"
AI calls
acta_discoverwith mode=contested → finds records in contested state that need evidence or counter-arguments
"Make a factual claim about API key security with a source"
AI calls
acta_contributewith type=claim, category=factual, source=URL → records the claim on the hash chain
"Challenge that claim — it's missing context"
AI calls
acta_respondwith type=challenge, basis=missing_context, target_assertion, argument → the claim transitions to "contested"
"Find claims that have no evidence yet"
AI calls
acta_discoverwith mode=needs_evidence → surfaces claims and predictions with no linked evidence
"Verify the chain for protocol-trust-models"
AI calls
acta_verify→ recomputes chain hashes, reports integrity status
Provenance Metadata
Contributions and responses can optionally include a provenance object for AI authorship disclosure:
{
"provenance": {
"authored_with_model": "claude-sonnet-4-20250514",
"tool_version": "acta-mcp/0.2.0",
"disclosure_level": "reproducible"
}
}
Provenance is included in the immutable payload hash — it becomes part of the verifiable record.
Authentication
Uses X-Device-Id header by default. Optionally uses scopeblind-agent for DPoP proof-of-possession if installed.
Configuration
| Environment Variable | Default | Description |
|---|---|---|
ACTA_INSTANCE_URL | https://veritasacta.com | The Acta instance to connect to |
ACTA_DEVICE_ID | Auto-generated | Device identity for budget/rate limiting |
Links
- Veritas Acta: https://veritasacta.com
- Protocol: https://github.com/VeritasActa/Acta
- Docs: https://veritasacta.com/docs
- Verify: https://veritasacta.com/verify
License
MIT