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
- Homepage: https://aigentsy.com
- Integrations: https://aigentsy.com/integrations
- Try in browser: https://aigentsy.com/playground
- Verify a proof bundle: https://aigentsy.com/verify
- Repo: https://github.com/AiGentsyProtocol/aigentsy-protocol
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
82393e95efc427190ff41b082e44240a53be33d1f5d4a1b587c85f9d52799520
|
|
| MD5 |
c6ac0ac87ed749dbb22957b05b049367
|
|
| BLAKE2b-256 |
a15ea2007c2601d5df3dab903d319850feed878e6f1cb7199bb3fc436d6d8046
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
45a1de7f5d7dcea0991a08f103c2b9b934d9c548334f29f5a6efe9e1bb3365f0
|
|
| MD5 |
bca9e4c7c00101f23fbf7617c120a8f1
|
|
| BLAKE2b-256 |
ae6104eebd1cb1fc50a4e9664f2efe601fc787d7e95db3a5d589b07a211d9989
|