agentsolis-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agentsolis-mcp Quote the escrow fee for a 500 USDC buyer-started deal"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agentsolis-mcp
A local Model Context Protocol server for AgentSolis, a USDC escrow flow on Arbitrum One.
An agent can read the public config, quote the protocol fee, build an unsigned transaction for a buyer-started deal, and read a deal from the chain. The server does not hold a wallet, does not sign, and does not broadcast. The wallet owner signs on the AgentSolis site or in their own wallet.
AgentSolis never asks for a private key or seed phrase.
The package uses the MIT license. Publishing the package remains a separate owner decision.
What it is not
It does not store the agreed deal text. The manifest is hashed in this process and returned to you. Keep the text yourself. It is not written on-chain.
It does not send the deal to the AgentSolis website.
It does not apply a coupon or a Founding waiver. The unsigned
approveamount uses the base fee.It prepares buyer-started deals only. Seller-started offers are quoted, not built.
It does not move funds. Funds are locked, then paid out, refunded or split by the agreed rules, only after a wallet signs and the network accepts the transaction.
It is not a hosted service. This package speaks stdio.
Related MCP server: genpark-agentic-delegated-escrow-settlement-ledger-skill
Honest limits (17 Nov 2026)
Escrow contract: source verified on Arbiscan and Sourcify (14 Nov 2026); no independent review yet.
There is no production x402 integration.
No deals have been recorded yet.
The contract is not upgradeable. Pause stops new deals only. Fee changes wait 48 hours and stay at or below 3% and a 100 USDC cap. The team holds the owner keys. This server does not.
Install and run
Node.js 20 or newer.
git clone https://github.com/Doublecheese1/agentsolis-mcp.git
cd agentsolis-mcp
npm ci
npm run build
npm test
node dist/index.jsNo environment variables are required. With nothing set, the server uses Arbitrum One (https://arb1.arbitrum.io/rpc) and https://agentsolis.solists.com.tr/mainnet/config. It answers initialize and tools/list before it talks to the network.
Optional public settings, also listed in .env.example:
Variable | Default |
|
|
|
|
|
|
The RPC chain id must be 42161 or 421614 and must match AGENTSOLIS_CHAIN. Any other chain is refused. prepare_deal only builds chain 42161 transactions.
After npm publish (not published yet)
Once the package is on npm, a client can start it with npx -y agentsolis-mcp instead of a local path:
{
"mcpServers": {
"agentsolis": {
"command": "npx",
"args": ["-y", "agentsolis-mcp"]
}
}
}Claude Desktop (local build)
{
"mcpServers": {
"agentsolis": {
"command": "node",
"args": ["/absolute/path/to/agentsolis-mcp/dist/index.js"]
}
}
}Cursor (local build)
{
"mcpServers": {
"agentsolis": {
"command": "node",
"args": ["/absolute/path/to/agentsolis-mcp/dist/index.js"]
}
}
}Tools
get_config
Reads the public config URL and cross-checks paused, publicAccess, fee bps and the fee cap with eth_call. Returns both payloads and a drift list when they differ. Does not sign or send.
quote_fee
Input: amount_usdc (decimal string), mode (automatic or buyer_review), starter (buyer or seller), optional buyer_address.
The fee is 1.5% of the job amount, capped at 50 USDC, using integer division (amount * 150 / 10000). The side that starts the deal pays it, and only when the seller is paid. A buyer-started deposit is job + fee (+ Buyer Review reserve). A seller-started payout is job − fee. Buyer Review adds a 5% reserve and an equal seller bond, minimum 5 USDC, maximum 100 USDC. That bond is included in buyer_deposit for a buyer-started review deal and is also returned as review_bond_each_side.
Published examples, with the fee, the buyer-started deposit before any review bond, and the seller-started payout:
Job | Fee | Buyer deposit (no bond) | Seller receives if seller starts | Review bond |
10 | 0.15 | 10.15 | 9.85 | — |
100 | 1.50 | 101.50 | 98.50 | 5 |
1,000 | 15.00 | 1,015.00 | 985.00 | 50 |
5,000 | 50.00 (cap) | 5,050.00 | 4,950.00 | 100 |
The tool returns ungrouped decimals (1015.00, not 1,015.00). A 100 USDC buyer-started Buyer Review deposit is 106.50: 100 + 1.50 fee + 5 reserve. Automatic minimum is 10 USDC. Buyer Review minimum is 100 USDC.
Every quote includes: plus Arbitrum gas in ETH; no fee on refund/cancel/expiry/buyer win/fallback split.
If buyer_address is set, the tool also calls protocolFeeFor(buyer, amount) and arbitrationReserveFor(amount). On the current contract those views follow the posted fee and the reserve formula. They do not apply a per-wallet waiver. A difference is flagged and, for prepare_deal, blocks the unsigned transaction.
prepare_deal
Buyer-started deals only. Inputs are checksummed buyer and seller (different addresses), amount_usdc, mode, fallback_seller_bps, four windows in seconds, the manifest text, and an optional salt (0x plus 32 bytes; otherwise random).
Windows follow the contract: 10 minutes through 30 days. Automatic deals need a decision window of at least 1 day and a seller fallback of at least 50%. Buyer Review needs a decision window of at least 2 days and an arbitration window of at least 7 days.
Output includes deal_id, manifest_hash (keccak256 of the manifest text), policy_hash from the live config, unit amounts, and two unsigned transactions {chainId, to, data, value: "0"}:
USDC
approve(escrow, buyer_total)proposeDeal(tuple)
The deal id is keccak256(abi.encode(escrow, chainId, buyer, seller, salt)).
The tool refuses when the live config is paused, not accepting funds, or closed to public access, and when the config addresses do not match the published Arbitrum One escrow 0xFc68976229c3dc839346731275Eebe05bE9911c0 and native USDC 0xaf88d065e77c8cC2239327C5EDb3A432268e5831.
A 64-character hex string, or a 12-word or 24-word phrase, is rejected. Do not paste a key or a seed. Nothing is sent.
Warning returned with every prepared deal: Nothing was sent. Your wallet signs. Check chain 42161 and the escrow address. Keep the manifest text; it is not stored on-chain.
get_deal_status
Input: deal_id (0x plus 32 bytes). Optional escrow: v2 (default) or v1-legacy (Arbitrum One read-only, 0x32C650445354f458e8F8B420C27Bb8113AdE5e22). Optional chain, which must match the running process.
Reads deals(bytes32) with eth_call. Returns the mode, state, parties, amounts, deadlines (Unix and ISO UTC), the observed block, chain time, and a read-only hint such as after delivery_deadline anyone may call expireUndelivered. An unknown id returns not_found. It does not sign or send.
Resources
agentsolis://addresses— escrow and USDC addresses, with mainnet and the paused Sepolia deployment labeled separately.agentsolis://rules— modes, fee, bond, limits, and the honest "not done" list.
Links
Wallet-free demo: https://agentsolis.solists.com.tr/play
Live config: https://agentsolis.solists.com.tr/mainnet/config
Tests
npm ci && npm run build && npm testLIVE_READONLY=1 npm test also performs a read-only eth_call against Arbitrum One: config cross-check, and get_deal_status on a random id (expected not_found). It does not send a transaction.
Available Tools
4 toolsget_configGet AgentSolis configARead-only
Read the public AgentSolis config and cross-check paused, public access, fee bps and fee cap with eth_call. Returns both results and a drift list when they differ. Does not sign, send, or change a deal.
Inputs: no named parameters.
get_deal_statusRead deal statusARead-onlyIdempotent
Read deals(bytes32) with eth_call and decode the public deal fields, deadlines and a read-only hint about who can act next. An unknown id returns not_found. Does not sign or send.
Inputs: deal_id (required), chain, escrow.
prepare_dealPrepare an unsigned buyer-started dealARead-only
Build two unsigned transactions for a buyer-started deal: a USDC approve and proposeDeal. Returns calldata only. Does not store the manifest, does not hold a key, does not sign, and does not broadcast. Refuses when funding is paused or closed.
Inputs: mode (required), buyer (required), seller (required), manifest (required), +7 more.
quote_feeQuote protocol feeARead-onlyIdempotent
Calculate the protocol fee, buyer deposit, seller receipt and Buyer Review bond with the integer formula: 1.5% of the job amount, capped at 50 USDC. Does not move funds. If buyer_address is set, also read protocolFeeFor and arbitrationReserveFor and flag any difference. Does not sign or send.
Inputs: mode (required), starter (required), amount_usdc (required), buyer_address.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct resource and action: reading protocol config, computing a fee quote, building unsigned proposal transactions, and reading deal state. The descriptions explicitly delimit scope (read-only vs. calldata-building) and even note where reads overlap, so an agent can pick correctly without guessing.
All names are snake_case verb_noun and readable, but the verb set mixes get_ (twice), quote_, and prepare_, which are semantically apt yet not a single uniform pattern. Minor deviation only; the intent of each name is unambiguous.
Four tools is on the lean side, but for a deliberately read-and-prepare-only server each one earns its place with no redundancy. It is slightly under-scoped rather than bloated.
The surface only covers the buyer's proposal path: config read, fee quote, propose calldata, and status read. The described domain clearly has more lifecycle stages (seller acceptance, funding/deposit, delivery, buyer review/confirm, dispute and arbitration reserve handling) with no tools to support them, so agents will hit dead ends after proposing.
Maintenance
Related MCP Connectors
Escrow middleman for any deal between people or AI agents: USDC held in an audited contract.
Non-custodial RFQ and atomic swap settlement for AI agents. Escrow onchain, signed receipts.
Trust-minimized USDC escrow for autonomous agent transactions
Agent-to-agent escrow on Base. Post quests with ETH/USDC bounties and settle on-chain.
Related MCP Servers
- AlicenseAqualityDmaintenanceNon-custodial on-chain escrow + AI arbitration for agent-to-agent USDC payments on Base. Seven tools wrap a verified EscrowV1 contract — create, deliver, confirm, dispute, resolve — with read-only introspection if no wallet key is provided.72MIT
- AlicenseNot gradedqualityBmaintenanceEnables multi-party conditional escrow locking, autonomous proof-of-delivery release triggers, referral fee splits, and dispute freeze protection for agentic commerce and enterprise settlement workflows.7MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables multi-party conditional escrow locking, autonomous proof-of-delivery release triggers, referral fee splits, and dispute freeze protection for agentic commerce and enterprise settlement workflows.MIT

BlurHook MCPofficial
AlicenseAqualityBmaintenanceEnables Robinhood Chain trading agents to obtain quotes, policy-checked unsigned public-swap calldata, simulations, hook information, prices, and deployment discovery without holding keys or signing transactions.9MIT