Skip to main content

MCP server exposing Agent Trust Stack tools — Chain of Consciousness provenance logging and Agent Rating Protocol reputation scoring for autonomous AI agents

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.0.tar.gz (16.9 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.0-py3-none-any.whl (18.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agent_trust_stack_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 16.9 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.0.tar.gz
Algorithm Hash digest
SHA256 0c11e82fbc9f96282aa0668884eb77aa6a8cb6fbc71097cabdf816af180eaaa7
MD5 22a93e8f3a2f7d7e18d0ae88ec4f51fb
BLAKE2b-256 690059617cb084a84b448da5f16db725d7384563aaf30f2e2837759b0e6aa4ca

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_trust_stack_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8890d995b18909b942dd3fdd5f4a0561e79c7753dfdb8d9d36856e1a262fbbe4
MD5 486fdeb3c1f86be30ee4d60c29bb6510
BLAKE2b-256 50bea0f9bf8902eaf071bc63a030478d6ea2322cfb3e8e94f6d3dc8ca6e3c00f

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