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.1.tar.gz (10.0 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.1-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.1.tar.gz
  • Upload date:
  • Size: 10.0 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.1.tar.gz
Algorithm Hash digest
SHA256 9c1993bdb03e116a637c6107af6fe76d05682467f77bdf768e947096ac18af4f
MD5 0cf873b3abc6d5cba29050d987e7decc
BLAKE2b-256 007248369de14e964a1f1ad068b13588be9cc7011a3c4d15cad6ddc2f382a962

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.2 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 340e27182bd939d32d143fcc2ecaa092340c7e840edbd7133f7cf2f78cdf7b13
MD5 c093790fa9b63e7f2ea17b0381c1b0f4
BLAKE2b-256 5ed7b38d2ca415e78bb143ed77211047ffec54ebedce3b3246430bce2c6fdddf

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