aigentsy-mcp 1.4.0

MCP server for the AiGentsy Settlement Protocol — proof, verification, exactly-once settlement, acceptance gating, and the Settlement Signal Beacon for Claude Desktop, Cursor, Cline, and any MCP-compatible runtime.

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_accept	api_key or AME_API_KEY	Record an ACCEPT decision on a deal. Produces a canonical, Vault-visible ACCEPTED event. Attribution-only via MCP (the runtime cannot carry a per-reviewer Ed25519 keypair through to a remote backend call); signing_mode="attribution_only" is labeled honestly in every response. For per-actor signed acceptance, use the signed-ingress flow directly — not available through MCP.
aigentsy_reject	api_key or AME_API_KEY	Record a REJECT decision on a deal. reason is REQUIRED and carried verbatim through to the canonical REJECTED event payload and the rejected counterparty's /vault/rejections. Attribution-only via MCP; same signing-mode honesty as aigentsy_accept.
aigentsy_settlement_signal	None	Advisory classifier — maps a plain-language work summary onto the AiGentsy stage vocabulary (proof_ready, verification_needed, acceptance_pending, settlement_eligible, ...). Conservative by design: no API call, no state change, no settlement triggered; defaults to applicable=false when uncertain.

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

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

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.