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 10 tools for proof creation, verification, 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 10 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.

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.0.0.tar.gz (8.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.0.0-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 8.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.0.0.tar.gz
Algorithm Hash digest
SHA256 5ab5df038ba71672cb3332d0362ddb53e7606e433a9dd8ccb7b09fc4d0e35468
MD5 9bee34925aac5370055e3fe9e556b8b8
BLAKE2b-256 072ca1a11177112ab3ce8c3b34fa78f0e27a77400cd12e65c12716b2daa7e984

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aigentsy_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 9.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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2b173e4afa735bf54f37b4c66921f9cbff2d780a7bdf6eaf8e4fd20b775d3343
MD5 156927a42094d31bb61f9309783bb1f4
BLAKE2b-256 cf1686f066fbb37c104be3d41566aab17cbf13550f6e6a6e8719f991af4cc298

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