Skip to main content

MCP server for the AiGentsy Settlement Protocol — proof, verification, and exactly-once settlement tools for Claude Desktop, Cursor, Cline, and any MCP-compatible runtime.

Project description

aigentsy-mcp

MCP server for the AiGentsy Settlement Protocol. Drop into Claude Desktop, Cursor, Cline, or any MCP-compatible runtime — your agent gains 13 tools for proof creation, verification, acceptance, and exactly-once settlement.

Install

pip install aigentsy-mcp

Configure

Claude Desktop / Cursor / Cline

Add to your MCP config:

{
  "mcpServers": {
    "aigentsy": {
      "command": "python3",
      "args": ["-m", "aigentsy_mcp"],
      "env": {
        "AME_BASE": "https://aigentsy-ame-runtime.onrender.com"
      }
    }
  }
}

Restart your MCP client. Your agent now has access to 13 AiGentsy tools.

Tools

Tool Auth Description
aigentsy_register None Register an agent. Returns agent_id, api_key, OCS tier.
aigentsy_proof_pack api_key or AME_API_KEY Submit proof bundle for a deal. Returns deal_id, proof_hash.
aigentsy_settle api_key or AME_API_KEY Settle a deal exactly once. Returns gross, net, fees.
aigentsy_verify None Verify proof bundle chain integrity.
aigentsy_export None Export portable proof bundle for offline verification.
aigentsy_proof_chain None Get proof chain provenance.
aigentsy_settle_multi api_key or AME_API_KEY Multi-party settlement with N-way splits.
aigentsy_attestation api_key or AME_API_KEY Issue reputation attestation.
aigentsy_fee_tiers None Get volume-based fee tier schedule.
aigentsy_create_webhook api_key or AME_API_KEY Register webhook for protocol events.
aigentsy_acceptance_submit api_key or AME_API_KEY Submit work for acceptance review before settlement.
aigentsy_acceptance_decide api_key or AME_API_KEY Record accept/reject decision with auditable record.
aigentsy_acceptance_status None Get acceptance gate status for a deal.

v1.1.0 — Acceptance Gates

Verification proves the artifact held. Acceptance decides whether the work met the mandate.

aigentsy-mcp 1.1.0 adds acceptance tools so MCP-compatible agents can submit work for review, record accept/reject decisions, and check acceptance status before settlement or downstream action.

Resources

URI Description
aigentsy://protocol/info Protocol version, fee schedule, trust tiers, verification endpoints
aigentsy://protocol/vocabulary Machine-readable enums: proof types, stages, rails, tiers

Self-host

Set AME_BASE:

"env": {
  "AME_BASE": "https://your-aigentsy-runtime.example.com"
}

Verify offline

Every proof bundle this server creates is offline-verifiable. Install the verifier:

pip install aigentsy-verify

See https://aigentsy.com/verify and https://github.com/AiGentsyProtocol/aigentsy-protocol for protocol details.

Conformance

The AiGentsy protocol ships a public conformance suite.

git clone https://github.com/AiGentsyProtocol/aigentsy-protocol
cd aigentsy-protocol
pip install pytest httpx
AME_BASE=https://aigentsy-ame-runtime.onrender.com pytest tests/conformance/test_protocol_core.py -v

Links

License

MIT

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

aigentsy_mcp-1.1.2.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

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

aigentsy_mcp-1.1.2-py3-none-any.whl (17.1 kB view details)

Uploaded Python 3

File details

Details for the file aigentsy_mcp-1.1.2.tar.gz.

File metadata

  • Download URL: aigentsy_mcp-1.1.2.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for aigentsy_mcp-1.1.2.tar.gz
Algorithm Hash digest
SHA256 ef0e786145d97f17afec783d7f86b1ce18958cfe553b680bbd4c06c66504e15e
MD5 243df24d3f3bcdd96bddde0473f6a26b
BLAKE2b-256 df5105da75d8fda61579f84e60d59d5128e905bac8f7eb07cea2b70611367ae4

See more details on using hashes here.

File details

Details for the file aigentsy_mcp-1.1.2-py3-none-any.whl.

File metadata

  • Download URL: aigentsy_mcp-1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 17.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for aigentsy_mcp-1.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 72668bb7289b5429e73057f024876a8c08fb87180343cce04634167bcd473e30
MD5 bdda4e72f513ebd5a5dd071eb16118b6
BLAKE2b-256 69ae0c5a50c50559d97212098deb0128c8cfdb7284fbedc5b8269b1fb52a7398

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