1.4.0

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

v1.3.1 — README Correction

Documentation-only patch. The 1.3.0 wheel shipped the correct code (the live 13 tools) but the packaged README still listed the three pre-G2 aspirational acceptance tools (aigentsy_acceptance_submit, aigentsy_acceptance_decide, aigentsy_acceptance_status) — none of which the 1.3.0 server actually registered. The README also still declared MIT in its License section, contradicting the Apache-2.0 metadata on the PyPI page. PyPI long-descriptions are immutable per-version, so 1.3.1 supersedes 1.3.0 with no code changes. Use pip install --upgrade aigentsy-mcp to pick up the corrected documentation.

v1.3.0 — G2 acceptance tools, Settlement Signal Beacon, Apache 2.0

Three live tools added; three pre-G2 aspirational tools removed (these had never actually registered in the wheel even when documented).

• aigentsy_accept — Record an ACCEPT decision. Attribution-only via MCP; signing_mode="attribution_only" labeled honestly.
• aigentsy_reject — Record a REJECT decision. reason REQUIRED and carried verbatim end-to-end.
• aigentsy_settlement_signal — Conservative advisory classifier. No API call.

Honest failure surfacing on accept/reject: every backend httpx.HTTPStatusError (401 / 403 / 404 / 409 / 422 / 500) is returned as a structured envelope with status_code + response body + the attempted decision — NEVER swallowed into a fake success.

License changed from MIT to Apache 2.0. Already-published 1.2.x remains MIT (immutable on PyPI); 1.3.0 onward ships Apache 2.0.

v1.2.1 — Offline-Verifiable Export

aigentsy_export now returns a spec-v2.0.0-compliant ProofPack bundle that passes aigentsy-verify.verify_bundle() against all five checks (bundle hash, event chain integrity, RFC 6962 Merkle inclusion, Ed25519 signed tree head, cross-reference). Previously the tool hit /proof/{deal_id}, which omitted bundle_hash, spec_version, merkle_inclusion, and signed_tree_head — making the returned object non-verifiable offline.

The wrapper now hits /protocol/proofs/{deal_id}/export and emits the spec-v2.0.0 bundle directly. No external tool signature change.

Also fixes a docstring drift in aigentsy_create_webhook: the docstring said "17 event types"; the runtime returns 19 (and the integrations page documents 19).

v1.2.0 — Wire Reconciliation

End-to-end calls now match the live runtime schema. Six tools that previously 422'd against production are fixed:

• aigentsy_settle now sends amount_usd and to_agent (was amount / counterparty_id). The external tool signature is unchanged — amount, counterparty_id, and actor_id are still accepted from callers; the wrapper translates them before sending.
• aigentsy_settle_multi now sends total_amount_usd (was total_amount).
• aigentsy_proof_pack no longer seeds a hardcoded asset_type field into proof_data. When proof_url is provided, it is routed to the top-level attachment_url field on ProofPackRequest, so proof types that require specific proof_data fields no longer reject the request.

No tool was renamed, removed, or had its external signature changed. If you were already calling these tools correctly, you do not need to change anything.

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

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

Apache 2.0. See LICENSE for the canonical text. Already-published 1.2.x remains MIT on PyPI by virtue of being append-only; 1.3.0 onward ships Apache 2.0 at both the package metadata layer (License-Expression + classifier) and the bundled LICENSE file.