acta-mcp
v0.2.2
Published
MCP server for Veritas Acta — contribute, challenge, verify, and query contestable public records from AI coding tools.
Maintainers
Readme
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-mcpThe 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
