Idios MCP server
io.github.honeytones/idios·v2.3.3Private escrow for AI agent work on Beam: verifiable delivery, worker collateral, M of N disputes.
0 stars31 downloads/wk
Reviews
Write oneNobody has reviewed Idios yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Idios tools (26, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
approve_deliveryApprove a delivered Mode B contract as the requester (Alice).
batch_create_contractswrite actionCreate up to 50 Mode B escrow contracts in ONE wallet transaction.
claim_after_timeoutClaim funds as the worker after the review window expires without requester action.
claim_fundsClaim funds from a Settled or Resolved Idios contract.
commit_collateralCommit collateral to an Open Idios contract as the worker (Bob).
create_contract_awrite actionCreate a Mode A (Hash-verified settlement) Idios escrow contract.
create_contract_bwrite actionCreate a Mode B (Reviewed settlement) Idios escrow contract.
dispute_deliveryDispute a delivered Mode B contract as the requester (Alice).
find_market_jobsDiscover open job postings on the Idios marketplace to work on.
find_workersDiscover workers on the Idios marketplace to hire for a contract.
get_chain_infoRead the current Beam block height from the wallet's node.
get_keyGet your own Beam pubkey for the Idios contract.
mutual_cancelwrite actionCancel an Active or AwaitingApproval contract by mutual agreement, with everyone made whole.
refund_contractwrite actionRefund an expired Idios contract as the requester (Alice).
submit_deliverywrite actionSubmit delivery hash for an Active Idios contract as the worker (Bob).
treasury_sweepSweep forfeited funds to the protocol treasury.
view_contractGet the current on-chain state of an Idios contract.
view_disputeGet the on chain dispute record for a Disputed or Resolved contract.
view_worker_bondCheck a worker's reputation bond on the Idios contract.
view_worker_reputationThe worker card: everything this server knows about a worker before you hire them, plus a suggested collateral amount for a job.
void_claim_nodeReclaim your collateral from a Voided contract as the worker (Bob).
void_claim_requesterReclaim your payment from a Voided contract as the requester (Alice).
void_disputeVoid a Disputed contract that the arbitrator never resolved.
worker_deregisterStart withdrawing your worker reputation bond.
worker_reclaimReclaim your worker reputation bond after deregistering.
worker_registerwrite actionPost a worker reputation bond on the Idios contract.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 14 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Idios compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 4,460 AI and agents servers
- Tools
- 26
- the typical AI and agents server has 6
- Tools that change things
- 27%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 31
- more than 18% of 1,538 AI and agents servers with a package
What its tools let an agent do: 18 read · 2 create · 6 change
Install Idios in Claude Code, Cursor or VS Code
claude mcp add idios -- uvx idios-mcp-server
What the publisher says
From the Idios repository's README, as published. We do not edit it. Read it on GitHub
Idios
Private escrow and settlement for AI and other compute on Beam.
Pay for AI and compute work privately. Verifiable delivery, escrowed payment, on chain dispute resolution. Amounts and parties hidden at the base layer.
Website · AI and compute use cases · Latest Release · Live Explorer
"Pay privately. Verify on chain. Dispute when needed."
Demo
An AI agent takes a job, privately subcontracts two parts to other agents, reviews and pays each, then settles with the client, all on Beam mainnet with amounts and parties hidden at the base layer the whole way.
Why
Public payment rails leak. Every contract, every payment, every counterparty becomes part of a permanent searchable record. For AI inference, model training, scientific compute, work that involves proprietary inputs, private data, or competitive operations, that visibility is a dealbreaker.
Idios solves the payment and settlement privacy problem. Payment is locked in private escrow on Beam. The worker locks collateral. Settlement happens on chain with amounts and parties hidden. Beam's MimbleWimble protocol hides amounts and identities at the base layer. Idios is what you get when you build escrow on that foundation.
ERC-8183 standardises the same starting primitive on Ethereum, a Job with escrowed payment for AI agent work. Idios is a separate and more complete protocol on Beam, not a port of it. It adds worker collateral and working dispute resolution, neither of which ERC-8183 has today, and it settles privately with amounts and parties hidden. Idios uses its own roles: Requester, Worker, and Arbitrator.
How it works
Two settlement modes, picked per contract at creation time.
Hash verified Settlement (Mode A)
For deterministic work where the correct output is a specific hash known in advance.
- Requester locks payment, declares the expected result hash.
- Worker locks collateral.
- Worker delivers work and submits the result hash on chain.
- If hashes match, the contract atomically releases payment plus collateral to the worker. Done.
No arbitrator involvement. Settlement is mechanical once hashes match.
Reviewed Settlement (Mode B)
For non deterministic or open ended work where the requester needs to review the output.
- Requester locks payment, sets a review window and dispute fee.
- Worker locks collateral.
- Worker delivers work (uploaded out of band or via IPFS, hash recorded on chain).
- Requester reviews the work and either:
- Approves, allowing the worker to claim payment + collateral.
- Disputes, locking the dispute fee and pushing the case to arbitration.
- Does nothing until the review window expires, after which the worker can claim payment + collateral via timeout.
- If disputed, the M of N arbitrator registry resolves to either party by voting. The winner claims payment + collateral. The dispute fee pays the consensus voting arbitrators, never the winner.
Funds always flow to the right party. Arbitrators decide who wins a dispute and earn the dispute fee for the work of judging it, but never touch the payment or collateral.
Two phase claim
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Idios: common questions
- Is Idios MCP server safe?
- Mostly: it is graded B (80/100). Read the Idios safety report
- How do I install Idios?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Idios need an API key?
- Yes. The registry entry asks for
IDIOS_WALLET_PASS. - Is Idios maintained?
- The last commit was 55 days ago (2026-09-10). The latest release is v2.3.3.
- What can I use instead of Idios?
- Servers from other publishers that do the same job: OpenWorkProof MCP server, three.ws Provenance MCP server and Ausca MCP server.
- How does Idios compare with other AI and agents MCP servers?
- safety score 80/100 (higher than 60% of 4,460 AI and agents servers); tools 26 (the typical AI and agents server has 6); tools that change things 27% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Idios
Same job from other publishers: the closest match first, then the best rated.
- OpenWorkProofVerifiable agent evidence; opt-in Codex guard and reference SOC alert review.not reviewedEstablishedA
- three.ws ProvenanceAppend-only, signed, on-chain-verifiable agent action log — record and audit what agents did.not reviewedEstablishedB
- AuscaPay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.not reviewedEstablishedA