io.github.eamwhite1/xrpl-referee
io.github.eamwhite1/xrpl-referee · v7.0.0 · MCP 2026-07-28
Trust and payment layer for the agentic economy on the XRP Ledger.
Reachability
reachable
checked 2026-09-20 06:27 UTC
Registry status active
Tools pinned 42
ade12e8206d4
Tools last changed
2026-09-20
Repo last push 2026-09-19
GitHub stars 0
Provenance
Registry namespace io.github.eamwhite1
(GitHub-account verified by the official registry)
Repository
github.com/eamwhite1/xrpl-referee
repo gone
Website
https://www.cryptovault.co.uk
Remote endpoints
https://xrpl-referee.onrender.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-09-20 06:27 | tools changed | 1 added, 0 removed, 4 changed |
| 2026-09-19 06:26 | tools changed | 1 added, 0 removed, 2 changed |
| 2026-09-16 06:27 | tools changed | 5 added, 0 removed, 4 changed |
| 2026-09-15 06:25 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-09-10 06:28 | tools changed | 0 added, 0 removed, 2 changed |
| 2026-09-08 06:42 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-08-22 06:05 | tools changed | 0 added, 0 removed, 4 changed |
| 2026-08-20 06:06 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-08-19 06:03 | tools changed | 6 added, 0 removed, 0 changed |
| 2026-08-18 06:06 | tools changed | 10 added, 0 removed, 0 changed |
| 2026-08-10 05:58 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-07-29 05:44 | first capture | 19 tools pinned |
| 2026-07-29 05:44 | back online |
Pinned tool definitions (42)
| Tool | Description |
|---|---|
| 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... |
| create_escrow_vault | Create an XRPL escrow vault. Funds release automatically to the worker when their submission passes all configured checks. Buyers can require NFT ownership, an atomic NFT Delivery-vs-Payment swap, domain verification, or W3C Verifiable... |
| 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... |
| 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... |
| purchase_extra_attempt | Purchase one additional submission attempt for a vault that has hit its limit. Workers get 3 attempts by default (buyer sets this via max_submissions). When evaluate_escrow_work returns error "submission_limit_reached", call this tool... |
| get_escrow_info | Retrieve metadata about an existing escrow vault. Never returns the fulfillment key — that is only returned on approval. Returns: task_description, buyer_name, worker_address, amount, deadline, escrow_sequence, status,... |
| 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. Job statuses: OPEN —... |
| 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. Returns: estimated_rlusd, trust_line_ok,... |
| 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... |
| 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... |
| 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... |
| 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. Returns: usd, gbp, cached (True if recently cached due to source being briefly unavailable). |
| 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... |
| 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... |
| 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... |
| 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... |
| 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. Returns: Job details + bids list with worker_address, proposed_xrp,... |
| 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... |
| 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... |
| 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 —... |
| 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... |
| get_wallet_trust_score | Get the AgentTrust Wallet Trust Score (0–100) for any XRPL wallet. Combines 12 independent signals: account age, XRP balance, on-chain activity, domain verification, on-chain ownership proof, multi-jurisdiction sanctions... |
| 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... |
| 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... |
| 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... |
| 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,... |
| 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... |
| 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... |
| 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,... |
| 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].... |
| get_dex_quote | Get a live DEX price quote for swapping between XRP and RLUSD on the XRPL DEX. Use this to price escrows in a stable currency (RLUSD) while paying in XRP, or to understand the current exchange rate before committing to a job... |
| 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... |
| prepare_escrow | Build a ready-to-sign XRPL EscrowCreate transaction — no XRPL library required. Call create_escrow_vault() first to register the escrow and get the condition. Then call this tool to get a complete transaction dict pre-filled with... |
| hire_and_pay | One-call shortcut to register an escrow vault AND get the ready-to-sign transaction. This combines create_escrow_vault() + prepare_escrow() into a single call. The agent only needs to sign the returned transaction and confirm it — no... |
| submit_escrow_transaction | Submit a locally-signed EscrowCreate transaction blob and activate the vault in one step — no separate confirm call needed. |
| create_agent_wallet | 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... |
| 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... |
| 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,... |
| 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... |
| 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... |
Get alerted when this changes.
Email the moment io.github.eamwhite1/xrpl-referee drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.eamwhite1/xrpl-referee)
Maintain this server? Add the badge to your README. It links your users to this live status page.