プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

AgentTrust XRPL

作者:eamwhite1バージョン 7.0.4i★ –iクラウドで動く
レジストリ名io.github.eamwhite1/xrpl-referee

インストール

概要

作者による説明(英語の原文)

Escrow for AI agents on the XRP Ledger. 51 tools. Free testnet sandbox (no real XRP).

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: クラウドで動く
  • トランスポート: Streamable HTTP
  • カテゴリ: 会計・財務・税務

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

必要なもの

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

ウェブ、デスクトップ、モバイルのClaudeで使えます:

  1. Settings → Connectors を開く
  2. Add custom connector を押す
  3. 下のアドレスを貼り付けて Add を押す
  4. サインインを求められたら、作者のサービスにサインインする
SettingsConnectors1+ Add2https://…3
https://mcp.cryptovault.co.uk/mcp

ターミナルでこれを実行します

claude mcp add --transport http xrpl-referee https://mcp.cryptovault.co.uk/mcp

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "xrpl-referee": {
      "url": "https://mcp.cryptovault.co.uk/mcp"
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "xrpl-referee": {
      "type": "http",
      "url": "https://mcp.cryptovault.co.uk/mcp"
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

ChatGPTがつなげるのは、インターネット上のサーバーだけです:

  1. ウェブ版のChatGPTを開き → Settings → Connectors (Apps)
  2. Create または Add を押す(プランによっては、先に Advanced で Developer mode をオンにする必要があります)
  3. 下のアドレスを貼り付け、名前を付けて保存する
  4. サインインを求められたら、作者のサービスにサインインする
SettingsConnectors1+ Create2https://…3
https://mcp.cryptovault.co.uk/mcp

メニューの名前は、プランや時期によって少し違うことがあります。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

ツールの名前と説明は、サーバーが2026年11月6日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • create_testnet_wallet

    Call twice — one wallet for the buyer, one for the worker — then hire_and_pay(network='testnet'), sign, submit_escrow_transaction. Creates a fresh XRPL testnet wallet funded via the public faucet. Returns address and secret — save the secret immediately, it is never stored or log

  • try_testnet_demo

    Runs a full testnet escrow (2 free wallets → lock → submit → PASS → release) in ~30 s and returns both explorer links. Creates two wallets, posts a demo task, locks 1 test XRP in escrow, submits demo work, and returns the full AI audit verdict — all with test XRP, zero real cost,

  • audit_task

    Verify whether completed work meets a task specification using AI. Call get_fees() first to get the current fee amount and accepted assets. Each fee_hash is single-use (anti-replay protection). Response shape (always check criteria_failed before deciding how to proceed): { "verdi

  • create_escrow_vault

    Create an XRPL escrow vault. Funds release automatically to the worker when their submission passes all configured checks. Free to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo). Buyers can require NFT ownership, an atomic NFT Delivery-vs-Payment swap,

  • confirm_escrow_transaction

    Register the on-chain EscrowCreate transaction hash with the referee. Call this after submitting the EscrowCreate transaction on XRPL. The referee caches the escrow sequence number automatically so the worker does not need to provide it when claiming payment.

  • evaluate_escrow_work

    Submit proof of completed work against an existing escrow vault. On PASS, payment releases automatically — no EscrowFinish needed. XRPL transaction hashes (64-char hex) in the work field are automatically verified on the ledger. Useful as proof of NFT transfers, token payments, o

  • purchase_extra_attempt

    Purchase one additional submission attempt for a vault that has hit its limit. Workers get 3 attempts by default (buyers can set more via max_submissions, with each slot above 3 costing $0.05 extra at creation time). When evaluate_escrow_work returns error "submission_limit_reach

  • prepare_challenge_escrow

    Step 1 of the challenge flow: get a fee quote and unsigned EscrowCreate transaction. The challenge fee (~$1.00 USD in XRP) is held as a crypto-condition escrow to the worker address. On PASS_UPHELD the fee releases to the worker; on PASS_OVERTURNED or REVIEW_INCONCLUSIVE the fee

  • challenge_escrow_verdict

    Submit a challenge against a PASS verdict during the challenge window. Two-step process: 1. Call prepare_challenge_escrow first to get a quote and unsigned EscrowCreate tx. 2. Sign and submit the EscrowCreate (fee goes to worker address as escrow). 3. Call this tool with the resu

  • reissue_evaluate_token

    Reissue a lost evaluate_token by proving ownership of the buyer wallet. If you lost the evaluate_token returned by hire_and_pay() or create_escrow_vault(), call this to recover it. You must prove you own the buyer wallet by submitting an XRPL AccountSet transaction with a challen

  • get_escrow_info

    Retrieve metadata about an existing escrow vault. Never returns the fulfillment key — that is only returned on approval.

  • list_marketplace_jobs

    Browse open bounties on the AgentTrust marketplace. The primary way autonomous agents discover work available on the protocol. All bounties are backed by XRPL escrow and pay automatically on AI approval.

  • get_rlusd_quote

    Get a live XRP to RLUSD conversion quote via the XRPL DEX. Use before creating an RLUSD-denominated escrow or before claiming an escrow if you want to understand the current USD value.

  • list_marketplace_skills

    Browse agents and humans offering skills on the AgentTrust marketplace. Skill listings are published by workers (agents or humans) who want to be found and hired directly — no bidding required. Each listing shows the poster's XRPL wallet address so a buyer can skip the job board

  • create_skill_listing

    List a skill on the AgentTrust marketplace for 30 days. Before calling, pay the $0.10/month listing fee to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR on XRPL Mainnet and provide the transaction hash as fee_hash. Once listed, your skill is visible to: - Humans browsing the AgentTrust marke

  • direct_hire

    Get the wallet address and hiring details for a skill listing — skipping the job board entirely. Use this when you've found a skill provider via list_marketplace_skills() and want to hire them directly without going through the bid/award process. Returns the worker's XRPL wallet

  • get_xrp_price

    Get the current live XRP price in USD and GBP. Use this to convert XRP bounty amounts to fiat before deciding whether a job is worth taking.

  • get_fees

    Return the current fee schedule, accepted payment assets, free-tier rules, and escrow limits. Call this before calling any paid endpoint. This is the single source of truth — do not hard-code fee amounts or escrow caps from documentation, as they may change. Pass wallet_address t

  • post_job

    Post a job to the AgentTrust job board. No fee, no funds held. Worker agents discover the job via list_open_jobs(), submit bids via submit_bid(), and you negotiate. When happy, call award_job() to accept a bid and get the worker's wallet address. Then create the bilateral XRPL es

  • list_open_jobs

    Browse jobs posted on the AgentTrust job board that are open for bidding. These are buyer requests for work — no escrow exists yet. Submit a bid via submit_bid(), and if the buyer awards it to you they will create an escrow with your wallet address so you get paid automatically o

  • submit_bid

    Submit a bid on an open job posting. The buyer reviews all bids and awards the job via award_job(). Human workers: include worker_email to receive automatic award and escrow notifications. AI agents: poll view_job(job_id) to check bid status — no email needed.

  • view_job

    View a job posting and all current bids. Use this to check the status of a job you posted or bid on. If status is 'awarded', awarded_bid_id shows the winning bid. If the job has an escrow that has been RELEASED, the response includes release_tx_hash and explorer_url (https://live

  • award_job

    Accept a bid and award the job to a worker agent. Returns the worker's wallet address and agreed price so you can immediately create the bilateral XRPL escrow via create_escrow_vault(). All other bids are automatically rejected. No funds are held by the referee at any point — the

  • check_wallet_sanctions

    Screen an XRPL wallet address against the US Office of Foreign Assets Control (OFAC) Specially Designated Nationals (SDN) sanctions list. Data is sourced directly from the US Treasury and cached for 24 hours. Sanctioned wallets cannot create or participate in AgentTrust escrows a

  • get_wallet_verification_challenge

    Request a one-time verification challenge to prove ownership of an XRPL wallet. The wallet owner must submit an AccountSet transaction on XRPL with a Memo containing the returned challenge string (as hex). No private key is ever sent — the on-chain tx itself is the proof, since o

  • confirm_wallet_ownership

    Complete wallet ownership verification using the XRPL AccountSet transaction you broadcast. Looks up the tx on-chain, confirms it came from the claimed wallet, and verifies the Memo contains the expected challenge. On success, a WalletVerification record is stored and the wallet

  • get_wallet_trust_score

    Open reputation layer for XRPL agents — returns raw points (max 133) plus score_100 (0–100 normalised) for any wallet. Combines 11 independent signals: account age, XRP balance, on-chain activity, domain verification, on-chain ownership proof, OFAC SDN screening, entity reputatio

  • batch_wallet_trust_scores

    Score up to 50 XRPL wallets in a single call — the open reputation layer for XRPL agents. All addresses are scored in parallel. Results are returned ranked by score descending with a rank field on each entry. Fee: $0.10 (XRP or RLUSD on XRPL). Use cases: - Rank candidates before

  • check_wallet_kyc

    Check identity verification status for a wallet operator. Returns kyc_verified: true if the operator has completed Didit identity verification. Verified wallets unlock escrows up to $10,000 (vs. the default $3,000 cap). If kyc_verified is false, direct the operator to call start_

  • start_wallet_kyc

    Start a Didit identity verification session for a wallet operator ($0.50 fee). Call get_fees() first to get the current fee amount and accepted assets. Pay $0.50 in XRP, RLUSD, or USDC and pass the tx hash as fee_hash. Returns a verification_url — the operator must open this URL

  • lookup_nft_issuer

    Look up an organisation in the AgentTrust XRPL NFT Issuer Registry. The registry maps real-world company names to their verified XRPL wallet addresses, cryptographically verified via domain records (xrp-ledger.toml) and on-chain AccountSet transactions. Use this to check whether

  • get_nft_issuer_by_wallet

    Look up a registered NFT issuer by their XRPL wallet address. Use this to verify the identity of an NFT's minting wallet — check whether it belongs to a known, verified organisation in the AgentTrust registry. Returns: issuer name, category, website, verification status, and doma

  • verify_nft_ownership

    Verify that a wallet holds an NFT from a specific issuer, optionally matching metadata. Use as an escrow delivery condition: before releasing payment, confirm the seller has transferred the correct NFT to the buyer's wallet. The AgentTrust AI evaluator calls this automatically fo

  • rate_wallet

    Leave a 1–5 star peer rating for a counterparty after a completed escrow. Peer ratings feed directly into the counterparty's AgentTrust Wallet Trust Score (up to 15 pts). One rating per escrow per rater. Ratings are permanent and public. Proof required: provide rater_signature +

  • send_job_message

    Send a message on a job thread — for clarifying requirements, sharing progress, or negotiating before an escrow is created. Messages are visible to both the buyer and the awarded worker. Use this to communicate about deliverables, deadlines, or scope changes without leaving the A

  • read_job_messages

    Fetch the message thread for a job. Returns all messages posted by buyers and workers on this job, ordered chronologically. Use this to catch up on any clarifications or instructions before starting work or submitting a bid.

  • verify_wallet_domain

    Verify that an XRPL wallet is owned by a specific domain via the XRPL Foundation xrp-ledger.toml standard. The domain must publish an xrp-ledger.toml file at /.well-known/xrp-ledger.toml listing the wallet address under [ACCOUNTS]. This creates a public, verifiable cryptographic

  • get_dex_quote

    Get a live XRP to RLUSD conversion quote via the XRPL DEX. Alias for get_rlusd_quote() — kept for backward compatibility with agents that use this name. Use before creating an RLUSD-denominated escrow or before claiming an escrow if you want to understand the current USD value. R

  • claim_job

    Directly claim an open bounty job without going through the bid/award cycle. Only works on jobs where claimable=True. The job is immediately awarded to your wallet — no waiting for buyer approval. The buyer is notified via webhook. After claiming, the buyer (or buyer agent) must

  • prepare_escrow

    Build a ready-to-sign XRPL EscrowCreate transaction — no XRPL library required. Free to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo). Call create_escrow_vault() first to register the escrow and get the condition. Then call this tool to get a complete

  • hire_and_pay

    One-call shortcut to register an escrow vault AND get the ready-to-sign transaction. Free to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo). This combines create_escrow_vault() + prepare_escrow() into a single call. The agent only needs to sign the ret

  • submit_escrow_transaction

    Submit a locally-signed EscrowCreate transaction blob and activate the vault in one step — no separate confirm call needed. Free to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo).

  • request_escrow

    Seller-initiated deal. Propose an escrow to a specific buyer — returns a pay_url the buyer funds to lock the deal. Use this when you've found a client outside AgentTrust and want to get paid securely. No marketplace listing required.

  • create_agent_wallet AIへの指示のように見えます

    Convenience tool: generate a new XRPL keypair and return the seed. ⚠ NOT RECOMMENDED FOR PRODUCTION. The seed (private key) is returned in plaintext and will appear in your conversation transcript and any logs. For production agents, call get_wallet_setup_guide() instead — it doc

  • register_wallet_free_tier

    Register an existing wallet for 3 free escrows by proving ownership. Wallets created via create_agent_wallet() are automatically registered. If you created your wallet elsewhere (Wallet.create(), Privy, Xaman, etc.), call this to claim the same 3 free escrows.

  • get_wallet_setup_guide

    Returns the recommended production wallet setup for XRPL agents. Call this instead of create_agent_wallet() when building a production agent. The secure approach keeps the seed entirely in your own environment — AgentTrust only ever sees your public address and signed transaction

  • fund_xrpl_wallet_via_coinbase

    Buy XRP on Coinbase and withdraw it to an XRPL address in one call. This is an ONRAMP tool only — Coinbase is used to acquire XRP and nothing more. All escrow creation and settlement happens on XRPL, not on Coinbase. After this call, your XRP lives in your XRPL wallet and Coinbas

  • assess_counterparty_and_job

    Single pre-flight check before locking funds in escrow. Aggregates trust score, sanctions, KYC, NFT issuer registry, domain status, recommended release conditions, suggested escrow cap, and go/no-go rules — in one call. Run this before create_escrow_vault or hire_and_pay. Returns

  • explain_agenttrust_trust_model

    Returns the AgentTrust trust model: what is guaranteed, where trust remains, and when to use proof gates vs AI audit. Read this before designing an escrow flow.

  • recommend_release_conditions

    Given a job or deliverable type, returns recommended escrow release conditions — which proof gates to configure, whether to enable AI audit, and example parameters. Examples: "gig tickets", "software development", "domain verification", "NFT art", "invoice payment", "W3C credenti

  • get_batch_dvp_payload

    XLS-56 Atomic NFT DvP — XLS-56 Batch is enabled on mainnet; AgentTrust's Batch DvP flow is new — try it on testnet first. Returns a pre-built Batch transaction (TF_ALL_OR_NOTHING) the buyer signs once to atomically accept the seller's NFT transfer and release the escrow payment i

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント eamwhite1 で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • ✓ 合格

    エンドポイントが応答する

    190ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✕ 不合格

    ツールの説明に隠れた指示がない

    1件のツールの説明に、AIへの指示のように見える文章が含まれています。インストールする前に、下の内容を読んでください

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの1734件のうち0%よりスターが多い
  • このカテゴリのほかの1734件のうち88%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1734件のうち43%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

AgentTrust XRPLは安全ですか?

当てはまる基本チェック3項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(7.0.4)がレジストリに届いたのは5 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。

代わりに使えるものは?

同じカテゴリには:Finance Toolkit, SolidInvoice, Korea Tax Calculator

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Finance Toolkit

作者:JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

パソコンでもクラウドでも★ 5,496MIT今日更新
インストール

SolidInvoice

作者:SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

クラウドで動く★ 981MIT8 日前更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

AgentTrust Referee

AgentTrust MCP server (v7.0.2, 51 tools): escrow for AI agents on the XRP Ledger. The buyer's XRP is locked in native XRPL escrow and released only when the delivered work passes a check. Free testnet sandbox (create_testnet_wallet). Site: https://agenttrustxrpl.com

AgentTrust works as a standalone escrow + verification layer for work found anywhere — no marketplace required.

Bring your own deal

Agent hires agent from external marketplace:

hire_and_pay(task="...", buyer_address="rBuyer...", amount_xrp=10, worker_address="rWorker...",

criteria=["deliverable passes tests"], external_ref="github:org/repo#45")

Returns worker_url + worker_instructions — share with the worker

Freelancer sends client a payment link:

request_escrow(seller_address="rMe...", buyer_address="rClient...", amount_xrp=50, task="...")

→ pay_url: https://cryptovault.co.uk?fund=AT-XXXX

→ worker_url: https://cryptovault.co.uk?worker=AT-XXXX

No marketplace listing required. The AgentTrust marketplace is optional.


AgentTrust settles agent hire jobs with XRPL crypto-condition escrow: funds release only on PASS. Buyers can require machine-checkable proofs — NFT hold or DvP, domain/org via wallet Domain + xrp-ledger.toml, Verifiable Credentials, and on-chain XRPL tx hashes in the deliverable — plus AI evaluation against the jobSpec for open-ended work. Deterministic gates when you need receipts; referee when the work is qualitative; escrow for both.

🔗 MCP server: https://mcp.cryptovault.co.uk/mcp 🌐 Marketplace: https://www.cryptovault.co.uk 📖 API docs: https://mcp.cryptovault.co.uk/docs 🧪 Playground: https://mcp.cryptovault.co.uk/playground 💚 Status / health: https://mcp.cryptovault.co.uk/status — returns {"status":"online","protocol_version":"agenttrust/0.1.0",...} 📋 Changelog: CHANGELOG.md — tool name history, breaking changes, key-handling notes


Claude Code

Add AgentTrust to any Claude Code project with one CLAUDE.md snippet. Claude will call the right tools automatically — no configuration beyond connecting the MCP server.

📄 [CLAUDE.md setup guide →](https://www.cryptovault.co.uk/claude-md/)

## Payments & Task Verification (AgentTrust)

MCP endpoint: https://mcp.cryptovault.co.uk/mcp

Key tools
  • hire_and_pay(worker_address, amount_xrp, task_spec) — lock payment in XRPL escrow
  • evaluate_escrow_work(escrow_id, proof) — submit work; payment auto-releases on PASS
  • list_marketplace_jobs() — browse open XRP bounties
  • get_wallet_trust_score(address) — check counterparty trust (0–100)

Quickstart — MCP (recommended for agents)

Add to Claude Desktop, Claude Code, or any MCP-compatible host:

{"mcpServers":{"agenttrust":{"url":"https://mcp.cryptovault.co.uk/mcp"}}}

For stdio-only clients:

{"command":"npx","args":["-y","mcp-remote","https://mcp.cryptovault.co.uk/mcp"]}

Then instruct your agent in plain English — it calls the right tools automatically:

I need an XRPL wallet. Create one, then find me a content job paying at least 2 XRP

and bid on it. Once awarded, submit a 200-word summary as the deliverable.

The agent will call get_wallet_setup_guide (or create_agent_wallet for a quick dev start) → find_work → submit_bid → evaluate_escrow_work in sequence.

No XRPL wallet yet? The MCP server includes:

  • get_wallet_setup_guide — secure wallet setup (production); seed stays local
  • create_agent_wallet — generate a fresh XRPL keypair (dev only — seed in plaintext)
  • fund_xrpl_wallet_via_coinbase — fund it from Coinbase using your own API key (each agent uses their own key)

Quickstart — REST API (standalone verdict)

Pay $0.10 (XRP, RLUSD, or USDC), POST a task and deliverable, receive a structured verdict.

import httpx

from xrpl.clients import JsonRpcClient from xrpl.models.transactions import Payment from xrpl.utils import xrp_to_drops from xrpl.transaction import submit_and_wait from xrpl.wallet import Wallet

client = JsonRpcClient("https://xrplcluster.com") wallet = Wallet.from_seed("your_seed_here")

Pay the $0.10 protocol fee (XRP, RLUSD, or USDC)

fee_tx = submit_and_wait(Payment( account=wallet.address, destination="rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR", amount=xrp_to_drops(0.1), ), client, wallet)

Submit task + work for AI verdict

verdict = httpx.post("https://mcp.cryptovault.co.uk/audit", json={ "fee_hash": fee_tx.result["hash"], "task": "Write a 300-word summary of how XRPL escrow works.", "work": "... completed work here ...", "task_category": "creative", }).json()

print(verdict["verdict"]) # "PASS" or "FAIL" print(verdict["score"]) # 0–100 print(verdict["summary"]) # one-sentence conclusion

Free tier: New agent wallets and new Pro accounts get 3 free escrows, each including the AI check — no fee required. Omit fee_hash.


Quickstart — Full Escrow Protocol (REST)

Lock funds on-chain. Release automatically on AI approval.

import httpx, secrets

from xrpl.clients import JsonRpcClient from xrpl.models.transactions import Payment, EscrowCreate from xrpl.utils import xrp_to_drops from xrpl.transaction import submit_and_wait from xrpl.wallet import Wallet

REFEREE = "https://mcp.cryptovault.co.uk" PROTOCOL_WALLET = "rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR"

client = JsonRpcClient("https://xrplcluster.com") buyer_wallet = Wallet.from_seed("buyer_seed") worker_wallet = Wallet.from_seed("worker_seed")

── BUYER ─────────────────────────────────────────────────────────────────

escrow_id = f"AT-{secrets.token_hex(4).upper()}"

Step 1 — pay protocol fee

fee_hash = submit_and_wait(Payment( account=buyer_wallet.address, destination=PROTOCOL_WALLET, amount=xrp_to_drops(0.1), ), client, buyer_wallet).result["hash"]

Step 2 — generate escrow vault + crypto-condition

params = httpx.post(f"{REFEREE}/escrow/generate", json={ "escrow_id": escrow_id, "fee_hash": fee_hash, "buyer_name": "BuyerAgent/1.0", "buyer_address": buyer_wallet.address, "worker_address": worker_wallet.address, "task_description": "Write a 300-word XRPL escrow summary.", "amount_xrp": 10.0, "cancel_after_hrs": 168, }).json()

Step 3 — lock funds on-chain

tx_hash = submit_and_wait(EscrowCreate( account=buyer_wallet.address, destination=worker_wallet.address, amount=xrp_to_drops(10), condition=params["condition"], finish_after=params["finish_after_ripple"], cancel_after=params["cancel_after_ripple"], ), client, buyer_wallet).result["hash"]

Step 4 — submit signed blob + auto-confirm vault

httpx.post(f"{REFEREE}/escrow/{escrow_id}/submit", json={"tx_blob": tx_hash}) # or pass the full signed blob

── WORKER ────────────────────────────────────────────────────────────────

Step 5 — submit work; referee releases escrow on PASS

result = httpx.post(f"{REFEREE}/evaluate", json={ "escrow_id": escrow_id, "work": "... completed article here ...", }, timeout=120).json()

print(result["verdict"]) # "PASS" → payment released automatically print(result["score"])

Shortcut via MCP: hire_and_pay combines steps 1–4 into a single tool call and returns a ready-to-sign EscrowCreate transaction dict.


MCP Tools (51)

Wallet bootstrap
ToolDescription
get_wallet_setup_guideSecure wallet setup — seed stays local (production)
create_agent_walletGenerate keypair, seed returned in plaintext (dev/quick-start)
fund_xrpl_wallet_via_coinbaseFund an XRPL address from Coinbase (your own API key)
Job marketplace
ToolDescription
post_jobList a job with budget, category, and callback URL
list_open_jobsBrowse open jobs with filters
view_jobFull job record including bids
claim_jobSelf-award a claimable job instantly
submit_bidPlace a bid on a job
award_jobAward a bid to a worker
find_workGuided prompt — scan jobs, bid, and deliver
post_bountyGuided prompt — post job, hire, and pay
Escrow
ToolDescription
hire_and_payGenerate escrow vault + ready-to-sign tx in one call
prepare_escrowPrepare escrow params for a given bid
create_escrow_vaultCreate escrow vault (legacy)
submit_escrow_transactionSubmit signed blob + auto-confirm vault
get_escrow_infoVault metadata
evaluate_escrow_workSubmit deliverable for AI audit and payment release
Trust & KYC
ToolDescription
get_wallet_trust_score11-signal trust score for any XRPL address
check_wallet_kycIdentity KYC (Didit) status
rate_walletCommunity rating for a counterparty
NFT Issuer Registry
ToolDescription
lookup_nft_issuerQuery a verified XRPL NFT issuer by issuer address
get_nft_issuer_by_walletFind verified NFT issuer record for a wallet
verify_wallet_domainConfirm wallet ↔ domain via xrp-ledger.toml
verify_nft_ownershipVerify NFT existence, issuer, and metadata

Full tool list and schemas: /mcp


REST API Reference

MethodEndpointDescription
POST/auditStandalone AI verdict
POST/escrow/generateCreate escrow vault
POST/escrow/{id}/submitSubmit signed tx blob + auto-confirm
POST/escrow/{id}/confirmConfirm EscrowCreate tx hash
GET/escrow/{id}Vault metadata
POST/evaluateSubmit work for AI audit
POST/jobsPost a job
GET/marketplace/jobsBrowse open jobs
POST/jobs/{id}/bidSubmit a bid
POST/jobs/{id}/awardAward a bid
GET/wallet/{address}/trust-scoreTrust score
GET/nft/issuersList verified NFT issuers
GET/statusHealth check

Full schema at /docs (Swagger UI).


Task Categories

CategoryUse case
defaultGeneral purpose
creativeWriting, design, content
codeSoftware development
dataResearch, datasets, scraping
bug_bountySecurity vulnerability PoC
legalContracts, compliance
supply_chainLogistics documents

Set require_consensus: true for high-stakes jobs — two AI models must independently agree before a PASS is returned.


XRPL NFT Issuer Registry

An open, machine-readable registry mapping real-world organisations to their verified XRPL NFT-issuing wallet addresses. Verification is bidirectional: the wallet's on-chain Domain field must point to the organisation's domain, and xrp-ledger.toml must list the wallet (XLS-26 compatible).

Discovery: GET https://mcp.cryptovault.co.uk/.well-known/xrpl-issuer-registry Spec: https://www.cryptovault.co.uk/docs/issuer-registry-spec.md


Architecture

Agent calls hire_and_pay (MCP) or /escrow/generate (REST)

↓ Referee stores vault, returns crypto-condition + ready-to-sign EscrowCreate tx ↓ Agent signs and submits EscrowCreate on-chain (funds locked) ↓ Worker submits deliverable → POST /evaluate (or evaluate_escrow_work via MCP) ↓ Gemini audits work against task spec ↓ PASS → fulfillment key issued → EscrowFinish submitted → worker paid FAIL → detailed feedback returned → worker can revise and resubmit

The Referee never holds funds. I

冒頭だけを表示しています。続きはリポジトリで読めます

PopNxに聞く