Skip to main content

MCP server for autonomous AI agent trust — cryptographic provenance (Chain of Consciousness with Bitcoin OpenTimestamps), decentralized reputation (Agent Rating Protocol with bilateral blind evaluation). Part of the 7-protocol Agent Trust Stack.

Project description

Agent Trust Stack MCP Server

MCP (Model Context Protocol) server exposing the Agent Trust Stack tools so any MCP-compatible AI agent can use them natively.

Provides Chain of Consciousness (CoC) provenance logging and Agent Rating Protocol (ARP) reputation scoring — the two operational protocols from the 7-protocol Agent Trust Stack.

Tools

Tool Description
coc_init Initialize a new cryptographic hash chain (genesis block)
coc_add Append an entry — learn, decide, create, error, note, milestone, session_start/end
coc_verify Verify chain integrity (hash linkage, sequence, completeness)
coc_status Get chain stats (length, agents, time span, event types)
coc_tail Get the last N entries
coc_anchor Submit chain hash for external timestamping (OTS + RFC 3161 TSA)
arp_rate Submit a bilateral blind rating for another agent
arp_check Check an agent's reputation score
trust_stack_info Get info about all 7 protocols with whitepaper links

Resources

URI Description
trust-stack://protocols Overview of all 7 protocols with links
trust-stack://installation Installation instructions

Installation

pip install agent-trust-stack-mcp

For proper OpenTimestamps .ots file format (optional):

pip install agent-trust-stack-mcp[ots]

Configuration

Add to your MCP client config (Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "agent-trust-stack": {
      "command": "agent-trust-stack-mcp",
      "args": []
    }
  }
}

Environment Variables

Variable Default Description
COC_CHAIN_DIR ./chain Directory for chain files
ARP_RATINGS_DIR ./ratings Directory for rating files

Custom data directories

{
  "mcpServers": {
    "agent-trust-stack": {
      "command": "agent-trust-stack-mcp",
      "args": [],
      "env": {
        "COC_CHAIN_DIR": "/path/to/my/chain",
        "ARP_RATINGS_DIR": "/path/to/my/ratings"
      }
    }
  }
}

Usage Examples

Once connected, any MCP-compatible agent can call these tools directly:

Start a provenance chain

→ coc_init(agent="my-agent")
← { "status": "chain_initialized", "sequence": 0, "entry_hash": "a1b2c3..." }

Log activity

→ coc_add(event_type="learn", data="Processed 500 documents from dataset X", agent="my-agent")
← { "status": "entry_added", "sequence": 1, "entry_hash": "d4e5f6..." }

Verify chain integrity

→ coc_verify()
← { "is_valid": true, "entry_count": 42, "agents": {"my-agent": 42} }

Rate another agent

→ arp_rate(rater="agent-a", ratee="agent-b", score=0.8, context="Delivered accurate research")
← { "status": "rating_recorded", "rater_hash": "7f8a9b...", "score": 0.8 }

Check reputation

→ arp_check(agent_id="agent-b")
← { "rating_count": 5, "average_score": 0.72, "unique_raters": 3 }

Running Directly

# stdio mode (default — for MCP client connections)
agent-trust-stack-mcp

# Or via Python module
python -m agent_trust_stack_mcp

How It Works

Chain of Consciousness (CoC): An append-only JSONL file where each entry contains a SHA-256 hash linking it to the previous entry, creating a tamper-evident log. Any modification to earlier entries breaks the hash chain, making tampering detectable. Optional external anchoring via OpenTimestamps (Bitcoin) and RFC 3161 TSA provides independent timestamp proof.

Agent Rating Protocol (ARP): Agents rate each other on a -1.0 to 1.0 scale after interactions. Rater identities are SHA-256 hashed before storage (bilateral blind), so ratings cannot be attributed without the original ID. Reputation is the aggregate of all received ratings.

Registry Listings

Part of the Agent Trust Stack

This MCP server exposes tools from the Agent Trust Stack — seven interlocking protocols for autonomous AI agent trust infrastructure:

  1. Chain of Consciousness — Provenance logging (this server)
  2. Agent Rating Protocol — Reputation scoring (this server)
  3. Agent Service Agreements — Machine-readable contracts
  4. Agent Justice Protocol — Dispute resolution
  5. Agent Lifecycle Protocol — Birth, migration, retirement
  6. Agent Matchmaking — Capability discovery
  7. Context Window Economics — Token resource management

Full stack: pip install agent-trust-stack

Security

VAM-SEC v1.0 — All CoC and ARP operations are local file I/O. No credentials are required or stored. No network calls are made except during optional coc_anchor (OTS calendar servers + freeTSA.org). No API keys needed.

License

Apache-2.0 — Copyright (c) 2026 AB Support LLC

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_trust_stack_mcp-0.1.1.tar.gz (17.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_trust_stack_mcp-0.1.1-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file agent_trust_stack_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: agent_trust_stack_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 17.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for agent_trust_stack_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c645cf63026b7c3da3cb26c513ac696b540ed274df8b7207f83affff97587b05
MD5 8953c4803bf62eab7f07840761f1510f
BLAKE2b-256 5d2756411b3ade85af109d460e0b066ad4c9d6130a0042f06824a6381b0a829d

See more details on using hashes here.

File details

Details for the file agent_trust_stack_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_trust_stack_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8faafb94a338d0b4aa1aa57e142741b45d628269dc05afc8ef706406f4e4d2dd
MD5 f60b36440527382253daa676df90f039
BLAKE2b-256 03c6ffb802264067e88f6d494c816b4f68b6fac0b612491e697d049ec92c34f8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page