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.3.tar.gz (10.5 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.3-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.3.tar.gz
  • Upload date:
  • Size: 10.5 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.3.tar.gz
Algorithm Hash digest
SHA256 aef8d30e812be6c6ae4147834e287472e94e9ea446795177086d9a0a87af1d23
MD5 d64c4eb44eff3a37d67f7ec3d714cb6f
BLAKE2b-256 e5a90777f45dbb9f4daaf28f724af4e51e7e3a64a7671244a5170d19426e31da

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 22.0 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 290dd306a0b06a9a8710b30bbd3d9c82a2e363027dde2d5c34b0a73f325a86d8
MD5 871536d9ca554c3a2aff56dcf98bf572
BLAKE2b-256 3b7ee687378d3492b4bd2bcdd8cca3e5eb166425af03b3cf9c5de3331ec2cc27

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