acta-mcp

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_discover with 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_contribute with type=claim, category=factual, source=URL → records the claim on the hash chain

"Challenge that claim — it's missing context" > AI calls acta_respond with type=challenge, basis=missing_context, target_assertion, argument → the claim transitions to "contested"

"Find claims that have no evidence yet" > AI calls acta_discover with 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