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

Uploaded Python 3

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.0.tar.gz
  • Upload date:
  • Size: 9.4 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.0.tar.gz
Algorithm Hash digest
SHA256 82393e95efc427190ff41b082e44240a53be33d1f5d4a1b587c85f9d52799520
MD5 c6ac0ac87ed749dbb22957b05b049367
BLAKE2b-256 a15ea2007c2601d5df3dab903d319850feed878e6f1cb7199bb3fc436d6d8046

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.6 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 45a1de7f5d7dcea0991a08f103c2b9b934d9c548334f29f5a6efe9e1bb3365f0
MD5 bca9e4c7c00101f23fbf7617c120a8f1
BLAKE2b-256 ae6104eebd1cb1fc50a4e9664f2efe601fc787d7e95db3a5d589b07a211d9989

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