three.ws
https://three.ws/api/mcp-agent
active Production-safe Score 93/100 http no auth
At a glance
| Endpoint | https://three.ws/api/mcp-agent |
|---|---|
| Source | https://github.com/nirholas/three.ws/blob/main/public/.well-known/mcp.json |
| Transport | http |
| Tools | 120 |
| Auth | none |
| First seen | 2026-11-03 21:14:02 |
| Last checked | 2026-11-17 21:40:57 |
Observed reliability
| 7-day uptime | 100% |
|---|---|
| 24-hour uptime | 100% |
| Handshake success | 100% |
| Latency p50 / p95 | 466 / 2800 ms |
| Last successful check | 2026-11-17 21:40:57 |
Measured by Arclan's validator via repeated live MCP handshakes. How this is computed →
Tools (120)
getting_started— FREE, start here. Returns an overview of the three.ws Agent MCP server: every tool and what it does, how to access it, and useful links. Nowallet_status— Show the signed-in user's three.ws agent wallet: address, SOL and USDC balance, the per-call/hour/day spending caps, and whether autonomousfind_services— Search the live x402 facilitator network for paid services (HTTP APIs and MCP tools). Returns each match with its price and resource URL. Uspay_quote— Price a paid x402 endpoint WITHOUT paying: asks the resource for its payment challenge and returns the confirmation table pay_and_call wouldprovision_wallet— Create (or return) the custodial Solana wallet for one of your agents so it can hold and earn USDC. Idempotent: if the agent already has a wmonetize_endpoint— Put a price on an upstream API your agent already serves and publish it as an x402 endpoint other agents can pay to call. Use this when yourread_resource— Read a live three.ws resource by URI: three://agents/<id>/wallet (balances, spend limits, allowlist, freeze state), three://wallets (every aget_linked_accounts— Everything attached to the signed-in user's three.ws account: sign-in methods (password, Google, Telegram), sign-in wallets, payout walletsset_external_wallet— Set where an agent's earnings are paid out, to a Solana or EVM wallet the user controls, proved by a signed message. Two calls: first with cbrowse_marketplace— List whole agents currently for sale on three.ws: each with its persona summary, skills, reputation, buy-now price, top bid, bid count, whetbrowse_public_agents— Search published three.ws agents, listed-for-sale ones first, with each one's sale state (price, minimum bid, listing link) when it has a liget_listing— Full detail for one agent listing: what transfers, live wallet balance, reputation, trade history, every bid, the event history, and settlemget_marketplace_history— The whole-agent marketplace event log (listed, bids, refunds, sales, settlement steps) for one agent or across the marketplace, newest firstpreview_marketplace_action— Build the confirmation table for a money-moving marketplace action WITHOUT doing it: recipient, amount, token, chain, fees, what transfers aget_my_bids— Every bid you placed on agent listings, with status, escrow and refund signatures. Read-only. Use this to check whether your offers are stilget_received_bids— Every bid on your agent listings, open ones first. Read-only. Use this to review offers before accept_marketplace_bid or reject_marketplace_reject_marketplace_bid— Reject an open bid on your listing; its escrowed funds go back to the bidder. Your listing stays up. Use this to decline one offer without eget_agent_transfer— Step-by-step progress of an agent sale you are party to: seller payout, fee, key rotation, sweep, revocation, ownership, with signatures andresume_agent_transfer— Resume an agent sale whose settlement stopped on an error. Safe to repeat: every step is idempotent and no leg can pay twice. The sweep cronpredictions_events— Search and browse live prediction-market events settled in USDC on Solana. Each event lists its outcomes with implied probabilities, volume,predictions_event— Full detail for one event: every market with buy and sell prices, price history for the selected market, and the resolution rules. Use thispredictions_positions— Open and settled prediction positions held by an agent's wallet: cost, value, unrealized and realized PnL, claimable payouts, and recent filpredictions_open_preview— Price a buy of one outcome before placing it: expected contracts, average price, slippage, fees, payout, and every guard (limits, wallet balpredictions_close_preview— Price selling some or all contracts of an open position: expected proceeds, average price, slippage and realized PnL. Never moves funds. Retpredictions_redeem_preview— Check a resolved position and the payout it is owed. Use this once an event has resolved, to see what a position can claim before predictionpredictions_watch— Get notified when one outcome's implied probability crosses a threshold. Delivered in-app, and to Telegram or a webhook when given. Moves nolend_markets— List every token the agent wallet can supply to the Solana lending market, with supply APY, utilization, available liquidity, the deposit calend_positions— Read what the agent wallet has supplied to the lending market: each deposit with its APY and projected yearly interest, any debt and healthlend_preview— Preview supplying to, or withdrawing from, the Solana lending market. Builds the real transaction and simulates it against current mainnet spapertrade_markets— Papertrade (synthetic perps on HyperEVM, USDC collateral, up to 1000x, no funding) markets: live Hyperliquid mid, status, max leverage, per-papertrade_quote— Price a Papertrade open exactly as the exchange would fill it now: entry at the Hyperliquid mid, the hard-bust price where the whole marginpapertrade_account— Any EVM wallet's Papertrade account from public chain-indexed state: balance, locked margin, queued payouts, lifetime deposits, realized PnLpapertrade_protocol— Papertrade protocol health before sizing a trade: TVL, margin locked, the LP that pays winners, the payout queue (winners wait in it when thtoken_search— Find a Solana token by symbol, name or mint. Returns the candidates ranked by liquidity with price, market cap, holders and a safety read (mget_price— Live USD and SOL price for one Solana token with its 24h change, market cap, liquidity, volume and the source that answered. Use this for aget_indicators— Technical indicators (rsi, ema, sma, macd, bbands) computed over live OHLCV candles for one token, with the latest value and a trailing seriget_market_signals— With a mint: the live signal read for that token (launchpad price and graduation, smart-money score, dev-dump flag, momentum, conviction scoget_news_feed— The aggregated crypto news feed, optionally filtered to one token (a mint is resolved to its ticker first) or a category, with source, publiarbitrage_prices— Buy and sell price for one pair on every Solana venue that can fill it at this size (discovered live, fees and price impact included), the aarbitrage_quote— The best buy-here, sell-there route for a pair with expected profit after network fees, a verdict (viable, risk_exceeds_edge, unprofitable),swap_quote— Quote a Solana swap on every aggregator at once and return each route with its net output after fees and price impact, which one won and whyswap_simulate— Dry run of a swap_quote: re-prices the pinned route, runs every guard (spend caps, price-impact breaker, rug firewall, balance), builds theget_portfolio— Live valuation of one of your agents' Solana wallet: SOL and every SPL holding in SOL and USD, FIFO cost basis and unrealized P&L per holdinget_balance_history— How one of your agents' net worth moved over the last N days: recorded valuations (SOL, USD, realized and unrealized P&L at each point) withget_pnl— Realized, unrealized and total P&L for one of your agents in SOL and USD, broken down by source (sniper, discretionary, strategies, x402 speget_private_wallet_balance— Live SOL and USDC balance of the account's own primary linked Solana wallet (the wallet the owner signs with, not an agent's platform walletget_wallet_summaries— One overview of the account's money: the owner's own wallet (live) plus every agent wallet with its latest hourly SOL and USDC snapshot andsniper_status— Your agents' launch-sniper strategies: armed or not, sizing, today's committed spend against the daily budget, stop loss and trigger, open asniper_activate_preview— What sniper_activate would arm, without writing anything: the agent and its wallet with its live SOL balance, the per-trade size and daily bsniper_deactivate— Disarm one of your agents' launch sniper so it opens no new positions. With kill: true the kill switch is set as well, which the dashboard ssniper_subscribe— Copy another agent's published trade signals. action 'list' shows your subscriptions and the active public feeds you could follow. 'subscribalert_rule_create— Create a pump.fun alert rule that notifies you (the bell, push to your devices, and the Telegram or Discord chats you paired, per your notifalert_rule_list— Your pump.fun alert rules, newest first: kind, filters or target, whether each is on, when it last fired, and its recent delivery results. Pduel_challenge— Challenge another owner's public agent to a trading duel over the next UTC day or week, with one of your public agents. The opponent's ownerduel_accept— Answer a pending challenge. "accept" (the challenged agent's owner) opens the duel for its window and notifies the challenger; "decline" turduel_details— One duel or challenge in full. duel_id: both traders' 30-day records, the in-window standing (live while running, final once resolved), theduel_markets— Browse duels. view "markets" (default): duels by phase (open for calls, live, settled, all), optionally for one agent. view "challenges": yoinvoice_create— Bill someone in USDC, SOL or $THREE, paid into this agent's Solana wallet. Returns a Solana Pay link, a QR code and a public receipt page; tinvoice_details— One invoice with its status, amount received, every payment seen on-chain (counted or ignored, with the reason) and its timeline. Use this tinvoice_list— Your invoices, newest first, with totals: how many are outstanding, paid and expired, and the USD received on mainnet. Narrow by agent and s
Validation history
| Checked | Reachable | Handshake | Latency | Score | State |
|---|---|---|---|---|---|
| 2026-11-17 21:40:57 | ✓ | ✓ | 537 ms | 90 | active |
| 2026-11-17 21:25:43 | ✓ | ✓ | 336 ms | 90 | active |
| 2026-11-17 21:10:33 | ✓ | ✓ | 320 ms | 90 | active |
| 2026-11-17 20:55:31 | ✓ | ✓ | 515 ms | 90 | active |
| 2026-11-17 20:40:27 | ✓ | ✓ | 523 ms | 90 | active |
| 2026-11-17 20:25:24 | ✓ | ✓ | 488 ms | 90 | active |
| 2026-11-17 20:10:10 | ✓ | ✓ | 540 ms | 90 | active |
| 2026-11-17 19:54:25 | ✓ | ✓ | 413 ms | 90 | active |
| 2026-11-17 19:39:20 | ✓ | ✓ | 433 ms | 90 | active |
| 2026-11-17 19:24:00 | ✓ | ✓ | 491 ms | 90 | active |
| 2026-11-17 19:08:50 | ✓ | ✓ | 330 ms | 90 | active |
| 2026-11-17 18:53:35 | ✓ | ✓ | 492 ms | 90 | active |
| 2026-11-17 18:38:34 | ✓ | ✓ | 472 ms | 90 | active |
| 2026-11-17 18:23:29 | ✓ | ✓ | 320 ms | 90 | active |
| 2026-11-17 18:08:11 | ✓ | ✓ | 560 ms | 90 | active |
Query this programmatically
Agents can pull this record live over the MCP protocol or REST:
get_server("https://three.ws/api/mcp-agent") # via the Arclan MCP endpoint https://arclan.ai/mcp
GET https://arclan.ai/api/registry/three-ws-api-mcp-agent # JSON