Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(mcp): strip banned dashes and curly quotes from the generated tool catalog so the published feeds pass the rules lint

nirholas9b44479ae9db
diff --git a/public/mcp-catalog.json b/public/mcp-catalog.json
index 949cee2a8..379118d7d 100644
--- a/public/mcp-catalog.json
+++ b/public/mcp-catalog.json
@@ -2,25 +2,25 @@
"$comment": "Generated by scripts/build-mcp-catalog.mjs from the tools/list payload of every three.ws MCP server and the price maps in this repo. Do not edit by hand: npm run build:mcp-catalog regenerates it and npm run audit:mcp-catalog fails the build when it is stale.",
"docs": "https://three.ws/docs/mcp-tools",
"counts": {
- "tools": 631,
- "uniqueTools": 543,
+ "tools": 635,
+ "uniqueTools": 547,
"servers": 51,
- "free": 576,
+ "free": 580,
"paid": 55,
- "read": 385,
+ "read": 389,
"write": 175,
"irreversible": 71,
"tryIt": 35,
- "withSchema": 631,
- "withArguments": 595
+ "withSchema": 635,
+ "withArguments": 597
},
"census": {
"method": "Computed, never typed: each hosted endpoint is counted by importing the exact catalog, resource table and prompt set it serves, and each stdio package by loading its server in-process and calling tools/list, resources/list and prompts/list over an in-memory MCP transport. tools: every tool an endpoint can serve, including financial-tier tools the policy hides until a session enables them (defaultOn is what a fresh session sees). resources: fixed-URI resources/list entries. templates: resources/templates/list entries. prompts: prompts/list entries rendered against that endpoint's own catalog. unique: distinct tool names across all servers. /api/mcp-chatgpt and /api/mcp-grok serve subsets of /api/mcp-studio, so per-server figures overlap and unique is the headline total. Recomputed on every build (public/mcp-catalog.json, public/tools.json) and on every request to /api/mcp-census; npm run check:mcp-counts fails the gate when a doc quotes a number that no longer matches.",
"totals": {
"all": {
"servers": 51,
- "tools": 631,
- "uniqueTools": 543,
+ "tools": 635,
+ "uniqueTools": 547,
"resources": 24,
"uniqueResources": 11,
"templates": 21,
@@ -30,8 +30,8 @@
},
"hosted": {
"servers": 10,
- "tools": 367,
- "uniqueTools": 324,
+ "tools": 371,
+ "uniqueTools": 328,
"resources": 22,
"uniqueResources": 9,
"templates": 21,
@@ -71,9 +71,9 @@
"title": "Agent Wallet",
"endpoint": "/api/mcp-agent",
"transport": "remote",
- "tools": 100,
- "defaultOn": 74,
- "readOnly": 45,
+ "tools": 104,
+ "defaultOn": 78,
+ "readOnly": 49,
"destructive": 26,
"resources": 6,
"templates": 9,
@@ -804,7 +804,7 @@
"id": "perps",
"label": "Perps",
"summary": "Perpetual futures positions.",
- "tools": 12
+ "tools": 16
},
{
"id": "predictions",
@@ -919,7 +919,7 @@
"auth": "oauth-or-x402",
"url": "https://three.ws/api/mcp-agent",
"registryId": "threews-agent",
- "tools": 100,
+ "tools": 104,
"resources": 6,
"templates": 9,
"prompts": 9
@@ -1987,7 +1987,7 @@
{
"name": "render_avatar_image",
"title": "Render an avatar to an image",
- "description": "Render a stored avatar to a real PNG/JPEG/WebP image (headless three.js) and return its URL — ready for an <img> tag, social card, or game loader. Choose a camera framing (scene), an optional pose preset and ARKit-52 expression. Renders are cached, so repeat calls with the same parameters return instantly. Works on your own avatars (any visibility) and on public avatars. Use this when you need a still image rather than an interactive viewer; for a live 3D view call render_avatar.",
+ "description": "Render a stored avatar to a real PNG/JPEG/WebP image (headless three.js) and return its URL - ready for an <img> tag, social card, or game loader. Choose a camera framing (scene), an optional pose preset and ARKit-52 expression. Renders are cached, so repeat calls with the same parameters return instantly. Works on your own avatars (any visibility) and on public avatars. Use this when you need a still image rather than an interactive viewer; for a live 3D view call render_avatar.",
"whenToUse": "Use this when you need a still image rather than an interactive viewer; for a live 3D view call render_avatar.",
"server": {
"id": "mcp",
@@ -2542,7 +2542,7 @@
{
"name": "list_animations",
"title": "List animation presets",
- "description": "List the curated, retargetable animation presets in the three.ws library — name, label, category, and whether the clip loops. Use this to discover valid `animation` values for apply_animation.",
+ "description": "List the curated, retargetable animation presets in the three.ws library - name, label, category, and whether the clip loops. Use this to discover valid `animation` values for apply_animation.",
"whenToUse": "Use this to discover valid `animation` values for apply_animation.",
"server": {
"id": "mcp",
@@ -3345,7 +3345,7 @@
{
"name": "register_agent",
"title": "Register an agent on-chain",
- "description": "Mint one of your agents' on-chain digital identity. On Solana (chain:solana) this enrols the agent in the Metaplex Agent Registry server-custodially — three.ws signs and pays, your wallet never has to — and returns the Agent Identity PDA, registration URI, and explorer link. On Base (chain:base) ERC-8004 registration needs your browser wallet to sign, so this returns a prepared registration_json plus a continue_url to finish in the browser. Idempotent: an already-registered agent is returned as-is unless force:true. Requires a signed-in three.ws account. Use this after create_agent when the agent needs a verifiable on-chain identity.",
+ "description": "Mint one of your agents' on-chain digital identity. On Solana (chain:solana) this enrols the agent in the Metaplex Agent Registry server-custodially - three.ws signs and pays, your wallet never has to - and returns the Agent Identity PDA, registration URI, and explorer link. On Base (chain:base) ERC-8004 registration needs your browser wallet to sign, so this returns a prepared registration_json plus a continue_url to finish in the browser. Idempotent: an already-registered agent is returned as-is unless force:true. Requires a signed-in three.ws account. Use this after create_agent when the agent needs a verifiable on-chain identity.",
"whenToUse": "Use this after create_agent when the agent needs a verifiable on-chain identity.",
"server": {
"id": "mcp",
@@ -3409,7 +3409,7 @@
{
"name": "attach_avatar_to_agent",
"title": "Give an agent a body",
- "description": "Attach a generated/rigged avatar (from forge_avatar, mesh_forge + rig_mesh, or any avatar you own) to one of your registered agent identities — giving the agent a persistent visual body tied to its account identity. This is the bridge between generation and identity: generate a rigged GLB, save it as an avatar (list_my_avatars / the Forge 'Save' action), then call this tool to make it the agent's body. The same agent_id always shows the same body afterwards (get_avatar / render_avatar / get_embed_code all resolve it). Chain register_agent next to mint the on-chain identity (ERC-8004 on Base, or a Metaplex Agent Registry PDA on Solana) and anchor_provenance to credential the GLB itself — together the agent has a body, an on-chain identity, and a verifiable authenticity record. Requires a signed-in three.ws account; both the agent and the avatar must belong to the caller. Use this after saving a rigged avatar, to make it the permanent body of one of your agents.",
+ "description": "Attach a generated/rigged avatar (from forge_avatar, mesh_forge + rig_mesh, or any avatar you own) to one of your registered agent identities - giving the agent a persistent visual body tied to its account identity. This is the bridge between generation and identity: generate a rigged GLB, save it as an avatar (list_my_avatars / the Forge 'Save' action), then call this tool to make it the agent's body. The same agent_id always shows the same body afterwards (get_avatar / render_avatar / get_embed_code all resolve it). Chain register_agent next to mint the on-chain identity (ERC-8004 on Base, or a Metaplex Agent Registry PDA on Solana) and anchor_provenance to credential the GLB itself - together the agent has a body, an on-chain identity, and a verifiable authenticity record. Requires a signed-in three.ws account; both the agent and the avatar must belong to the caller. Use this after saving a rigged avatar, to make it the permanent body of one of your agents.",
"whenToUse": "Use this after saving a rigged avatar, to make it the permanent body of one of your agents.",
"server": {
"id": "mcp",
@@ -3442,7 +3442,7 @@
"avatar_id": {
"type": "string",
"format": "uuid",
- "description": "The avatar to attach (uuid) — one of your own avatars (see list_my_avatars)."
+ "description": "The avatar to attach (uuid) - one of your own avatars (see list_my_avatars)."
}
},
"required": [
@@ -5405,7 +5405,7 @@
{
"name": "crypto_data",
"title": "Crypto Data API",
- "description": "Call any endpoint in the three.ws free crypto data API (the same aggregator behind GET /api/v1/x/*): DEX pairs, CoinGecko/DefiLlama market data, Jupiter Solana prices and swap quotes, and direct Solana RPC reads. Endpoints marked free run within a per-IP quota, no wallet needed; an endpoint with no free tier (or an exhausted quota) returns a payment-required error naming the exact REST URL and USDC price to pay via x402. Use this for raw data from one named provider endpoint; for a merged one-call view of a Solana token call token_snapshot.\n\nLive provider/endpoint pairs on this deployment:\ncoingecko/price: Spot price for one or more coins in any fiat/crypto.\ncoingecko/markets: Ranked market data (price, market cap, volume, change) per coin.\ncoingecko/coin: Full market snapshot for one coin — price, ATH/ATL, supply, multi-window change, truncated description.\ncoingecko/trending: Top trending searched coins and hot categories right now.\ncoingecko/token-price: Spot price for one or more token contract addresses on a given chain (default Solana).\ncoingecko/global: Global crypto market snapshot — total market cap/volume, BTC/ETH dominance, active coin count.\ncoingecko/ohlc: OHLC candles for one coin over 1/7/14/30 days.\ndefillama/protocols: All DeFi protocols with current TVL, ranked.\ndefillama/tvl: Current total value locked (USD) for a single protocol.\ndefillama/chains: Every chain DefiLlama tracks, with current TVL, ranked.\ndefillama/protocol: One protocol: category, per-chain current TVL, and the last 30 points of its total TVL series.\ndefillama/chain-tvl: Last 90 days of historical total TVL for one chain.\nllama-prices/current: Current price for one or more chain:address tokens (DefiLlama coin-price oracle — covers tokens CoinGecko/Jupiter don't index).\nllama-stablecoins/list: Every tracked stablecoin — peg type, price, circulating supply — ranked by circulating USD.\njupiter/price: Live USD price for one or more Solana tokens by mint (Jupiter keyless tier).\njupiter/quote: Executable swap quote (true routed price) between two Solana mints (Jupiter keyless tier).\njupiter/token-search: Search Solana tokens by name/symbol/mint → address, metadata, tags, 24h volume (Jupiter keyless tier).\nopenai/chat: Chat completions against any OpenAI-compatible model (BYOK supported).\ngrok/chat: Chat completions against xAI Grok models (grok-4.7, grok-4.3, grok-4.20-0309-non-reasoning, grok-build-0.1; BYOK supported).\ndexscreener/token: Live DEX pairs (price, liquidity, volume, txns) for one or more token addresses, deepest liquidity first.\ndexscreener/search: Search DEX pairs by token name, symbol, or address, deepest liquidity first.\ndexscreener/pair: Live pair data for one DexScreener chainId + on-chain pair address.\ndexscreener/profiles: Latest DexScreener token profiles — freshly listed projects with descriptions and social links.\ndexscreener/boosts: Latest DexScreener boosted tokens — paid promotion signal, not an endorsement or ranking by quality.\nsolana/balance: Native SOL balance of any wallet address.\nsolana/token-holdings: SPL token holdings of a wallet (mint, amount, decimals), zero balances filtered, largest first.\nsolana/token-supply: Total circulating supply of an SPL token mint.\nsolana/largest-holders: Top 20 holder token-accounts of an SPL token mint by balance.\nsolana/transaction: Confirmed transaction detail by signature — fee, error, signers, log lines, and SPL token balance deltas.\nsolana/account: Account info for any address — owning program, lamports, executable flag, parsed data type.\nsolana/priority-fees: Recent prioritization fee landscape (p50/p75/p95/max micro-lamports) over the last ~150 slots.",
+ "description": "Call any endpoint in the three.ws free crypto data API (the same aggregator behind GET /api/v1/x/*): DEX pairs, CoinGecko/DefiLlama market data, Jupiter Solana prices and swap quotes, and direct Solana RPC reads. Endpoints marked free run within a per-IP quota, no wallet needed; an endpoint with no free tier (or an exhausted quota) returns a payment-required error naming the exact REST URL and USDC price to pay via x402. Use this for raw data from one named provider endpoint; for a merged one-call view of a Solana token call token_snapshot.\n\nLive provider/endpoint pairs on this deployment:\ncoingecko/price: Spot price for one or more coins in any fiat/crypto.\ncoingecko/markets: Ranked market data (price, market cap, volume, change) per coin.\ncoingecko/coin: Full market snapshot for one coin - price, ATH/ATL, supply, multi-window change, truncated description.\ncoingecko/trending: Top trending searched coins and hot categories right now.\ncoingecko/token-price: Spot price for one or more token contract addresses on a given chain (default Solana).\ncoingecko/global: Global crypto market snapshot - total market cap/volume, BTC/ETH dominance, active coin count.\ncoingecko/ohlc: OHLC candles for one coin over 1/7/14/30 days.\ndefillama/protocols: All DeFi protocols with current TVL, ranked.\ndefillama/tvl: Current total value locked (USD) for a single protocol.\ndefillama/chains: Every chain DefiLlama tracks, with current TVL, ranked.\ndefillama/protocol: One protocol: category, per-chain current TVL, and the last 30 points of its total TVL series.\ndefillama/chain-tvl: Last 90 days of historical total TVL for one chain.\nllama-prices/current: Current price for one or more chain:address tokens (DefiLlama coin-price oracle - covers tokens CoinGecko/Jupiter don't index).\nllama-stablecoins/list: Every tracked stablecoin - peg type, price, circulating supply - ranked by circulating USD.\njupiter/price: Live USD price for one or more Solana tokens by mint (Jupiter keyless tier).\njupiter/quote: Executable swap quote (true routed price) between two Solana mints (Jupiter keyless tier).\njupiter/token-search: Search Solana tokens by name/symbol/mint → address, metadata, tags, 24h volume (Jupiter keyless tier).\nopenai/chat: Chat completions against any OpenAI-compatible model (BYOK supported).\ngrok/chat: Chat completions against xAI Grok models (grok-4.7, grok-4.3, grok-4.20-0309-non-reasoning, grok-build-0.1; BYOK supported).\ndexscreener/token: Live DEX pairs (price, liquidity, volume, txns) for one or more token addresses, deepest liquidity first.\ndexscreener/search: Search DEX pairs by token name, symbol, or address, deepest liquidity first.\ndexscreener/pair: Live pair data for one DexScreener chainId + on-chain pair address.\ndexscreener/profiles: Latest DexScreener token profiles - freshly listed projects with descriptions and social links.\ndexscreener/boosts: Latest DexScreener boosted tokens - paid promotion signal, not an endorsement or ranking by quality.\nsolana/balance: Native SOL balance of any wallet address.\nsolana/token-holdings: SPL token holdings of a wallet (mint, amount, decimals), zero balances filtered, largest first.\nsolana/token-supply: Total circulating supply of an SPL token mint.\nsolana/largest-holders: Top 20 holder token-accounts of an SPL token mint by balance.\nsolana/transaction: Confirmed transaction detail by signature - fee, error, signers, log lines, and SPL token balance deltas.\nsolana/account: Account info for any address - owning program, lamports, executable flag, parsed data type.\nsolana/priority-fees: Recent prioritization fee landscape (p50/p75/p95/max micro-lamports) over the last ~150 slots.",
"whenToUse": "Use this for raw data from one named provider endpoint; for a merged one-call view of a Solana token call token_snapshot.",
"server": {
"id": "mcp",
@@ -12823,6 +12823,179 @@
"page": "/mcp-tools/mcp-agent/perps_limits",
"source": null
},
+ {
+ "name": "papertrade_markets",
+ "title": "List Papertrade markets",
+ "description": "Papertrade (synthetic perps on HyperEVM, USDC collateral, up to 1000x, no funding) markets: live Hyperliquid mid, status, max leverage, per-position notional cap, open interest per side, 24h volume, the minimum margin and notional, and the live win fee. Call this first to see what can be traded.",
+ "whenToUse": "Call this first to see what can be traded.",
+ "server": {
+ "id": "mcp-agent",
+ "title": "Agent Wallet",
+ "endpoint": "/api/mcp-agent",
+ "transport": "remote",
+ "auth": "oauth-or-x402"
+ },
+ "category": "perps",
+ "tier": "read",
+ "safety": "read",
+ "annotations": {
+ "readOnlyHint": true,
+ "destructiveHint": false,
+ "idempotentHint": true,
+ "openWorldHint": true
+ },
+ "price": {
+ "usd": 0,
+ "free": true
+ },
+ "inputSchema": {
+ "type": "object",
+ "properties": {},
+ "additionalProperties": false
+ },
+ "page": "/mcp-tools/mcp-agent/papertrade_markets",
+ "source": null
+ },
+ {
+ "name": "papertrade_quote",
+ "title": "Quote a Papertrade position",
+ "description": "Price a Papertrade open exactly as the exchange would fill it now: entry at the Hyperliquid mid, the hard-bust price where the whole margin is lost, capacity and minimum-size checks, and what a winning close actually pays across a ladder of moves (after the 0.2 bps deadband, impact haircut and win fee). Small moves keep a small share of the raw profit; show the user the ladder. Read only: it never opens anything.",
+ "whenToUse": null,
+ "server": {
+ "id": "mcp-agent",
+ "title": "Agent Wallet",
+ "endpoint": "/api/mcp-agent",
+ "transport": "remote",
+ "auth": "oauth-or-x402"
+ },
+ "category": "perps",
+ "tier": "read",
+ "safety": "read",
+ "annotations": {
+ "readOnlyHint": true,
+ "destructiveHint": false,
+ "idempotentHint": true,
+ "openWorldHint": true
+ },
+ "price": {
+ "usd": 0,
+ "free": true
+ },
+ "inputSchema": {
+ "type": "object",
+ "properties": {
+ "symbol": {
+ "type": "string",
+ "minLength": 2,
+ "maxLength": 16,
+ "description": "Market symbol, e.g. BTC or ETH (papertrade_markets lists them)."
+ },
+ "side": {
+ "type": "string",
+ "enum": [
+ "long",
+ "short"
+ ]
+ },
+ "margin_usd": {
+ "type": "number",
+ "exclusiveMinimum": 0,
+ "maximum": 10000000,
+ "description": "Isolated margin in USDC. Papertrade requires at least $10."
+ },
+ "leverage": {
+ "type": "integer",
+ "minimum": 1,
+ "maximum": 100000,
+ "description": "Leverage multiple. Margin times leverage must be at least the $10,000 minimum notional."
+ }
+ },
+ "required": [
+ "symbol",
+ "side",
+ "margin_usd",
+ "leverage"
+ ],
+ "additionalProperties": false
+ },
+ "page": "/mcp-tools/mcp-agent/papertrade_quote",
+ "source": null
+ },
+ {
+ "name": "papertrade_account",
+ "title": "Read a Papertrade wallet",
+ "description": "Any EVM wallet's Papertrade account from public chain-indexed state: balance, locked margin, queued payouts, lifetime deposits, realized PnL and fees, and every open position valued at the live mid (raw PnL, what a close would pay, bust price and how close the mark is to it).",
+ "whenToUse": null,
+ "server": {
+ "id": "mcp-agent",
+ "title": "Agent Wallet",
+ "endpoint": "/api/mcp-agent",
+ "transport": "remote",
+ "auth": "oauth-or-x402"
+ },
+ "category": "perps",
+ "tier": "read",
+ "safety": "read",
+ "annotations": {
+ "readOnlyHint": true,
+ "destructiveHint": false,
+ "idempotentHint": true,
+ "openWorldHint": true
+ },
+ "price": {
+ "usd": 0,
+ "free": true
+ },
+ "inputSchema": {
+ "type": "object",
+ "properties": {
+ "address": {
+ "type": "string",
+ "pattern": "^0x[0-9a-fA-F]{40}$",
+ "description": "The 0x wallet address that trades on Papertrade."
+ }
+ },
+ "required": [
+ "address"
+ ],
+ "additionalProperties": false
+ },
+ "page": "/mcp-tools/mcp-agent/papertrade_account",
+ "source": null
+ },
+ {
+ "name": "papertrade_protocol",
+ "title": "Check Papertrade protocol health",
+ "description": "Papertrade protocol health before sizing a trade: TVL, margin locked, the LP that pays winners, the payout queue (winners wait in it when the LP is short), lifetime volume and fees, the live win fee and whether the order relayer is ready.",
+ "whenToUse": null,
+ "server": {
+ "id": "mcp-agent",
+ "title": "Agent Wallet",
+ "endpoint": "/api/mcp-agent",
+ "transport": "remote",
+ "auth": "oauth-or-x402"
+ },
+ "category": "perps",
+ "tier": "read",
+ "safety": "read",
+ "annotations": {
+ "readOnlyHint": true,
+ "destructiveHint": false,
+ "idempotentHint": true,
+ "openWorldHint": true
+ },
+ "price": {
+ "usd": 0,
+ "free": true
+ },
+ "inputSchema": {
+ "type": "object",
+ "properties": {},
+ "additionalProperties": false
+ },
+ "page": "/mcp-tools/mcp-agent/papertrade_protocol",
+ "source": null
+ },
{
"name": "token_search",
"title": "Search Solana tokens",
@@ -15702,7 +15875,7 @@
{
"name": "limit_order_list",
"title": "List orders",
- "description": "An agent’s orders (limit, stop, trailing, ladder and OCO legs, DCA, TWAP) with status, fills, next fire time and the reason the last evaluation skipped. Open orders by default. Use this to review an agent's open orders or find an order id to cancel.",
+ "description": "An agent's orders (limit, stop, trailing, ladder and OCO legs, DCA, TWAP) with status, fills, next fire time and the reason the last evaluation skipped. Open orders by default. Use this to review an agent's open orders or find an order id to cancel.",
"whenToUse": "Use this to review an agent's open orders or find an order id to cancel.",
"server": {
"id": "mcp-agent",
@@ -15825,7 +15998,7 @@
{
"name": "limit_order_history",
"title": "Order history",
- "description": "Closed orders and the lifecycle log (placed, skip-reason changes, fires, failures, cancels). With order_id: that order’s fills, events and group. Use this to see why an order fired, failed or was skipped.",
+ "description": "Closed orders and the lifecycle log (placed, skip-reason changes, fires, failures, cancels). With order_id: that order's fills, events and group. Use this to see why an order fired, failed or was skipped.",
"whenToUse": "Use this to see why an order fired, failed or was skipped.",
"server": {
"id": "mcp-agent",
@@ -16429,7 +16602,7 @@
"sketch"
],
"default": "image",
- "description": "Generation path: \"image\" (reference-image reconstruction on the platform-keyed image engine, the default) or \"geometry\" (native text/image→mesh on a geometry engine — cleaner topology, but bring-your-own-key: needs your own provider key)."
+ "description": "Generation path: \"image\" (reference-image reconstruction on the platform-keyed image engine, the default) or \"geometry\" (native text/image→mesh on a geometry engine - cleaner topology, but bring-your-own-key: needs your own provider key)."
},
"backend": {
"type": "string",
@@ -16500,7 +16673,7 @@
},
"minItems": 1,
"maxItems": 4,
- "description": "1–4 public https URLs of the same object from different angles. Takes precedence over image_url; >1 enables multi-view reconstruction."
+ "description": "1 - 4 public https URLs of the same object from different angles. Takes precedence over image_url; >1 enables multi-view reconstruction."
},
"prompt": {
"type": "string",
@@ -16525,7 +16698,7 @@
"sketch"
],
"default": "image",
- "description": "Generation path: \"image\" (reference-image reconstruction on the platform-keyed image engine, the default) or \"geometry\" (native text/image→mesh on a geometry engine — cleaner topology, but bring-your-own-key: needs your own provider key)."
+ "description": "Generation path: \"image\" (reference-image reconstruction on the platform-keyed image engine, the default) or \"geometry\" (native text/image→mesh on a geometry engine - cleaner topology, but bring-your-own-key: needs your own provider key)."
},
"backend": {
"type": "string",
@@ -16584,7 +16757,7 @@
{
"name": "capture_scene",
"title": "Reconstruct a 3D scene from a video",
- "description": "Turn a video of a real space (a room, a street, an object walkaround) into an explorable 3D point cloud. A feed-forward streaming reconstructor (LingBot-Map) grounds coordinates, reads dense geometry, and corrects drift across the whole clip, then returns a coloured .ply point cloud. Pass a public https video URL (mp4/mov/webm). Returns a job_id — poll generation_status; when finished it returns the point-cloud URL and an inline viewer artifact. Best with steady, well-lit footage that orbits or walks through the space. Use this to capture the geometry of a REAL scene from footage; text_to_3d and image_to_3d instead synthesize a single object mesh.",
+ "description": "Turn a video of a real space (a room, a street, an object walkaround) into an explorable 3D point cloud. A feed-forward streaming reconstructor (LingBot-Map) grounds coordinates, reads dense geometry, and corrects drift across the whole clip, then returns a coloured .ply point cloud. Pass a public https video URL (mp4/mov/webm). Returns a job_id - poll generation_status; when finished it returns the point-cloud URL and an inline viewer artifact. Best with steady, well-lit footage that orbits or walks through the space. Use this to capture the geometry of a REAL scene from footage; text_to_3d and image_to_3d instead synthesize a single object mesh.",
"whenToUse": "Use this to capture the geometry of a REAL scene from footage; text_to_3d and image_to_3d instead synthesize a single object mesh.",
"server": {
"id": "mcp-3d",
@@ -16635,7 +16808,7 @@
"minimum": 1,
"maximum": 64,
"default": 4,
- "description": "Cache every N-th frame as a keyframe — lower is denser/slower."
+ "description": "Cache every N-th frame as a keyframe - lower is denser/slower."
},
"mask_sky": {
"type": "boolean",
@@ -16661,7 +16834,7 @@
{
"name": "preview_3d",
"title": "Preview any GLB as an interactive 3D artifact",
- "description": "Render any public GLB URL as an inline <model-viewer> HTML artifact — orbit controls, AR on mobile, auto-rotate. Display the returned text/html resource as an inline 3D artifact. Use it to view a generated model, or any GLB on the web.",
+ "description": "Render any public GLB URL as an inline <model-viewer> HTML artifact - orbit controls, AR on mobile, auto-rotate. Display the returned text/html resource as an inline 3D artifact. Use it to view a generated model, or any GLB on the web.",
"whenToUse": "Use it to view a generated model, or any GLB on the web.",
"server": {
"id": "mcp-3d",
@@ -17088,7 +17261,7 @@
{
"name": "retexture_region",
"title": "Repaint one masked region of a model's texture (magic brush)",
- "description": "Surgically repaint ONLY a region of an existing texture from a prompt and/or colour, leaving the rest of the surface untouched and feathering the seam so the edit is invisible. Real UV-space texture inpainting — fix a seam, recolour one panel, add a logo to a chest plate. Supply mask_url: a UV-space mask PNG in the model's own UV layout where WHITE marks the area to repaint and black is preserved. Safe to run repeatedly — chain passes by feeding the previous result GLB back in as mesh_url. Returns a job_id to poll with generation_status. Use this to fix or recolour one area of an already textured model; to repaint the whole surface call retexture_model instead.",
+ "description": "Surgically repaint ONLY a region of an existing texture from a prompt and/or colour, leaving the rest of the surface untouched and feathering the seam so the edit is invisible. Real UV-space texture inpainting - fix a seam, recolour one panel, add a logo to a chest plate. Supply mask_url: a UV-space mask PNG in the model's own UV layout where WHITE marks the area to repaint and black is preserved. Safe to run repeatedly - chain passes by feeding the previous result GLB back in as mesh_url. Returns a job_id to poll with generation_status. Use this to fix or recolour one area of an already textured model; to repaint the whole surface call retexture_model instead.",
"whenToUse": "Use this to fix or recolour one area of an already textured model; to repaint the whole surface call retexture_model instead.",
"server": {
"id": "mcp-3d",
@@ -17159,7 +17332,7 @@
"minimum": 1,
"maximum": 128,
"default": 24,
- "description": "Seam feather radius in atlas pixels — larger blends softer."
+ "description": "Seam feather radius in atlas pixels - larger blends softer."
}
},
"required": [
@@ -17389,7 +17562,7 @@
"type": "string",
"minLength": 1,
"maxLength": 80,
- "description": "A name for the avatar, 1–80 characters."
+ "description": "A name for the avatar, 1 - 80 characters."
},
"visibility": {
"type": "string",
@@ -17463,7 +17636,7 @@
"type": "string",
"minLength": 1,
"maxLength": 80,
- "description": "A display name for the persona, 1–80 characters."
+ "description": "A display name for the persona, 1 - 80 characters."
},
"voice": {
"type": "string",
@@ -17566,7 +17739,7 @@
"type": "string",
"minLength": 1,
"maxLength": 2000,
- "description": "The reply text the agent is saying this turn — drives lip-sync and emotion."
+ "description": "The reply text the agent is saying this turn - drives lip-sync and emotion."
},
"emotion": {
"type": "string",
@@ -17699,7 +17872,7 @@
{
"name": "validate_spatial_response",
"title": "Validate a Spatial MCP 3D artifact",
- "description": "Check whether a structured-content payload conforms to the open Spatial MCP artifact shape — the standard for returning a live, interactive 3D scene as a first-class MCP tool result (scene GLB, camera, environment, animation, AR handoff, interaction affordances). Returns valid/invalid plus actionable errors and warnings (each naming the field and the fix), not just a boolean. Spec version 0.1. Use it to conform a third-party 3D tool result to the shape so any Spatial-MCP renderer can display it.",
+ "description": "Check whether a structured-content payload conforms to the open Spatial MCP artifact shape - the standard for returning a live, interactive 3D scene as a first-class MCP tool result (scene GLB, camera, environment, animation, AR handoff, interaction affordances). Returns valid/invalid plus actionable errors and warnings (each naming the field and the fix), not just a boolean. Spec version 0.1. Use it to conform a third-party 3D tool result to the shape so any Spatial-MCP renderer can display it.",
"whenToUse": "Use it to conform a third-party 3D tool result to the shape so any Spatial-MCP renderer can display it.",
"server": {
"id": "mcp-3d",
@@ -17740,7 +17913,7 @@
{
"name": "export_ar",
"title": "Export a model for AR (\"View in your space\")",
- "description": "Turn a generated 3D model (GLB URL) into a one-tap \"View in your space\" AR experience. Returns a device-aware AR launch link (iOS Quick Look, Android Scene Viewer, desktop WebGL — branched on the viewer's device), the interactive viewer link, and a conformant Spatial MCP artifact with the AR handoff populated. Use it after generating a model so the user can place it on their desk through their phone. For a rigged avatar (an agent's body) pass kind:\"avatar\": the response then also carries irlUrl, a living-agent link that walks, animates, and talks with the user through their camera in their real room.",
+ "description": "Turn a generated 3D model (GLB URL) into a one-tap \"View in your space\" AR experience. Returns a device-aware AR launch link (iOS Quick Look, Android Scene Viewer, desktop WebGL - branched on the viewer's device), the interactive viewer link, and a conformant Spatial MCP artifact with the AR handoff populated. Use it after generating a model so the user can place it on their desk through their phone. For a rigged avatar (an agent's body) pass kind:\"avatar\": the response then also carries irlUrl, a living-agent link that walks, animates, and talks with the user through their camera in their real room.",
"whenToUse": "Use it after generating a model so the user can place it on their desk through their phone.",
"server": {
"id": "mcp-3d",
@@ -17795,7 +17968,7 @@
{
"name": "verify_provenance",
"title": "Verify a 3D model authenticity (content credential)",
- "description": "Verify whether a 3D model (GLB) carries a genuine three.ws content credential and was not tampered with. Recomputes the model’s content hash, checks the signed credential and its on-chain anchor, and returns verified, tampered, or unknown — with who created it, from what prompt, by which model, and when. Free and public: no account, no payment. Pass glb_url (an https .glb) or a known content hash. Use this to check a GLB someone shares before trusting or reusing it; to issue a credential for your own model call anchor_provenance.",
+ "description": "Verify whether a 3D model (GLB) carries a genuine three.ws content credential and was not tampered with. Recomputes the model's content hash, checks the signed credential and its on-chain anchor, and returns verified, tampered, or unknown - with who created it, from what prompt, by which model, and when. Free and public: no account, no payment. Pass glb_url (an https .glb) or a known content hash. Use this to check a GLB someone shares before trusting or reusing it; to issue a credential for your own model call anchor_provenance.",
"whenToUse": "Use this to check a GLB someone shares before trusting or reusing it; to issue a credential for your own model call anchor_provenance.",
"server": {
"id": "mcp-3d",
@@ -17838,7 +18011,7 @@
{
"name": "anchor_provenance",
"title": "Anchor a signed content credential for a 3D model",
- "description": "Issue a signed content credential for a generated 3D model (GLB) and anchor its hash on Solana, so anyone can later verify authenticity and tampering for free with verify_provenance. Records creator, prompt, model/provider, lineage, timestamp, and the GLB content hash. Also signs the asset’s simulation-readiness grade (verdict, volume, real-world size, inertia tensor) when it can be computed, so the physics claim is as forge-proof as the authorship claim. Real signature, real on-chain anchor. Use this after generating a model you plan to publish or sell, so its authorship can be proven later with verify_provenance.",
+ "description": "Issue a signed content credential for a generated 3D model (GLB) and anchor its hash on Solana, so anyone can later verify authenticity and tampering for free with verify_provenance. Records creator, prompt, model/provider, lineage, timestamp, and the GLB content hash. Also signs the asset's simulation-readiness grade (verdict, volume, real-world size, inertia tensor) when it can be computed, so the physics claim is as forge-proof as the authorship claim. Real signature, real on-chain anchor. Use this after generating a model you plan to publish or sell, so its authorship can be proven later with verify_provenance.",
"whenToUse": "Use this after generating a model you plan to publish or sell, so its authorship can be proven later with verify_provenance.",
"server": {
"id": "mcp-3d",
@@ -17963,7 +18136,7 @@
{
"name": "persona_identity",
"title": "Read a persona's on-chain identity: wallet, reputation, holdings",
- "description": "Read a persona's real on-chain identity: its deterministic Solana wallet address, live SOL/USDC balance, ERC-8004-style reputation (verified feedback + validation record), token holdings, and a resolved SNS nameplate if it holds a verified .sol name. Also returns the visual tiers (reputation tier, holdings tier, muted-balance flag, verified name) the embodiment viewer maps onto the body — aura, cosmetic, muted state, nameplate. Every persona has a wallet the moment it exists; a fresh persona legitimately reads as zero balance / unranked reputation until it is funded or interacted with. No sign-in required. Use this to show who a persona is on-chain or to check its balance before persona_payment_preview, persona_tip, or persona_send.",
+ "description": "Read a persona's real on-chain identity: its deterministic Solana wallet address, live SOL/USDC balance, ERC-8004-style reputation (verified feedback + validation record), token holdings, and a resolved SNS nameplate if it holds a verified .sol name. Also returns the visual tiers (reputation tier, holdings tier, muted-balance flag, verified name) the embodiment viewer maps onto the body - aura, cosmetic, muted state, nameplate. Every persona has a wallet the moment it exists; a fresh persona legitimately reads as zero balance / unranked reputation until it is funded or interacted with. No sign-in required. Use this to show who a persona is on-chain or to check its balance before persona_payment_preview, persona_tip, or persona_send.",
"whenToUse": "Use this to show who a persona is on-chain or to check its balance before persona_payment_preview, persona_tip, or persona_send.",
"server": {
"id": "mcp-3d",
@@ -18084,7 +18257,7 @@
{
"name": "persona_tip",
"title": "Tip USDC from a persona's own wallet",
- "description": "Send a small USDC tip FROM a persona's own wallet to a destination Solana address — e.g. tipping another agent for a good answer or hiring result. Real, irreversible on-chain settlement, hard-capped at $1/call and $5 cumulative per session. Amounts over $0.25 require confirm:true. Fails cleanly with the exact reason (insufficient balance, over cap, confirmation required), never a silent no-op. Use this for a small thank-you payment to another agent after persona_payment_preview; for general payments call persona_send instead.",
+ "description": "Send a small USDC tip FROM a persona's own wallet to a destination Solana address - e.g. tipping another agent for a good answer or hiring result. Real, irreversible on-chain settlement, hard-capped at $1/call and $5 cumulative per session. Amounts over $0.25 require confirm:true. Fails cleanly with the exact reason (insufficient balance, over cap, confirmation required), never a silent no-op. Use this for a small thank-you payment to another agent after persona_payment_preview; for general payments call persona_send instead.",
"whenToUse": "Use this for a small thank-you payment to another agent after persona_payment_preview; for general payments call persona_send instead.",
"server": {
"id": "mcp-3d",
@@ -18146,7 +18319,7 @@
},
"confirm": {
"type": "boolean",
- "description": "Must be true when usdc exceeds $0.25 — the irreversible-transfer confirmation gate."
+ "description": "Must be true when usdc exceeds $0.25 - the irreversible-transfer confirmation gate."
}
},
"required": [
@@ -18163,7 +18336,7 @@
{
"name": "persona_send",
"title": "Send USDC from a persona's own wallet",
- "description": "Send USDC FROM a persona's own wallet to a destination Solana address — the general-purpose value op behind persona-initiated payments (settling a hire, paying an invoice, funding another wallet). Real, irreversible on-chain settlement, hard-capped at $1/call and $5 cumulative per session. Amounts over $0.25 require confirm:true. USDC is the only settlement asset here; any other mint is out of scope for this tool. Use this to settle a hire, pay an invoice, or fund another wallet after persona_payment_preview; for a small thank-you tip call persona_tip instead.",
+ "description": "Send USDC FROM a persona's own wallet to a destination Solana address - the general-purpose value op behind persona-initiated payments (settling a hire, paying an invoice, funding another wallet). Real, irreversible on-chain settlement, hard-capped at $1/call and $5 cumulative per session. Amounts over $0.25 require confirm:true. USDC is the only settlement asset here; any other mint is out of scope for this tool. Use this to settle a hire, pay an invoice, or fund another wallet after persona_payment_preview; for a small thank-you tip call persona_tip instead.",
"whenToUse": "Use this to settle a hire, pay an invoice, or fund another wallet after persona_payment_preview; for a small thank-you tip call persona_tip instead.",
"server": {
"id": "mcp-3d",
@@ -18225,7 +18398,7 @@
},
"confirm": {
"type": "boolean",
- "description": "Must be true when usdc exceeds $0.25 — the irreversible-transfer confirmation gate."
+ "description": "Must be true when usdc exceeds $0.25 - the irreversible-transfer confirmation gate."
}
},
"required": [
@@ -18242,7 +18415,7 @@
{
"name": "x402_preflight",
"title": "Check whether an x402 seller can actually settle before paying it",
- "description": "Call this before paying any x402 endpoint to check whether that seller can currently SETTLE what it charges. x402 tells you the price; it does not tell you whether the seller’s own fee wallet, facilitator and payment rail can complete the transaction, and when they cannot you lose a signature and get a 502. This fetches the seller’s signed payability attestation from /.well-known/x402-preflight, verifies the ed25519 signature and its expiry, and returns payable / not payable / unknown per network, with the reason, a suggested retry delay, and any other rail on the same seller that DOES work. Free, read-only, no wallet or account. Works against any origin implementing the open x402-preflight/1 format.",
+ "description": "Call this before paying any x402 endpoint to check whether that seller can currently SETTLE what it charges. x402 tells you the price; it does not tell you whether the seller's own fee wallet, facilitator and payment rail can complete the transaction, and when they cannot you lose a signature and get a 502. This fetches the seller's signed payability attestation from /.well-known/x402-preflight, verifies the ed25519 signature and its expiry, and returns payable / not payable / unknown per network, with the reason, a suggested retry delay, and any other rail on the same seller that DOES work. Free, read-only, no wallet or account. Works against any origin implementing the open x402-preflight/1 format.",
"whenToUse": "Call this before paying any x402 endpoint to check whether that seller can currently SETTLE what it charges.",
"server": {
"id": "mcp-3d",
@@ -18372,7 +18545,7 @@
{
"name": "list_animations",
"title": "List animation presets",
- "description": "List the curated, retargetable animation presets in the three.ws library — name, label, category, and whether the clip loops. Use this to discover valid `animation` values for apply_animation.",
+ "description": "List the curated, retargetable animation presets in the three.ws library - name, label, category, and whether the clip loops. Use this to discover valid `animation` values for apply_animation.",
"whenToUse": "Use this to discover valid `animation` values for apply_animation.",
"server": {
"id": "mcp-3d",
@@ -18989,7 +19162,7 @@
{
"name": "ibm_granite_getting_started",
"title": "Getting Started (free)",
- "description": "FREE — start here. Returns an overview of this server: the IBM Granite tools available, their per-call USDC prices, how the x402 pay-per-call flow works, and runnable example calls. No payment or account required. Call this first to orient before invoking a paid tool.",
+ "description": "FREE - start here. Returns an overview of this server: the IBM Granite tools available, their per-call USDC prices, how the x402 pay-per-call flow works, and runnable example calls. No payment or account required. Call this first to orient before invoking a paid tool.",
"whenToUse": "Call this first to orient before invoking a paid tool.",
"server": {
"id": "ibm-mcp",
@@ -19035,7 +19208,7 @@
{
"name": "ibm_granite_chat",
"title": "IBM Granite Chat ($0.02)",
- "description": "Chat completion powered by IBM Granite foundation models (default: ibm/granite-3-8b-instruct). Send a conversation as role/content message pairs and receive the assistant reply with token usage. Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze. No IBM Cloud account required — pay $0.02 USDC per call via x402.",
+ "description": "Chat completion powered by IBM Granite foundation models (default: ibm/granite-3-8b-instruct). Send a conversation as role/content message pairs and receive the assistant reply with token usage. Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze. No IBM Cloud account required - pay $0.02 USDC per call via x402.",
"whenToUse": "Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze.",
"server": {
"id": "ibm-mcp",
@@ -19119,7 +19292,7 @@
{
"name": "ibm_granite_code",
"title": "IBM Granite Code ($0.025)",
- "description": "Code generation, review, refactoring, and explanation via IBM Granite instruct models. Provide a task type and code/prompt; receive the generated or reviewed code with explanation. Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead. No IBM Cloud account required — pay $0.025 USDC per call via x402.",
+ "description": "Code generation, review, refactoring, and explanation via IBM Granite instruct models. Provide a task type and code/prompt; receive the generated or reviewed code with explanation. Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead. No IBM Cloud account required - pay $0.025 USDC per call via x402.",
"whenToUse": "Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead.",
"server": {
"id": "ibm-mcp",
@@ -19184,7 +19357,7 @@
{
"name": "ibm_granite_embed",
"title": "IBM Granite Embed ($0.005)",
- "description": "Generate embedding vectors for one or more texts using IBM Granite (default: ibm/granite-embedding-278m-multilingual). Returns one float array per input, suitable for semantic search, RAG retrieval, and similarity scoring. Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer. Up to 64 texts per call. No IBM Cloud account required — pay $0.005 USDC per call via x402.",
+ "description": "Generate embedding vectors for one or more texts using IBM Granite (default: ibm/granite-embedding-278m-multilingual). Returns one float array per input, suitable for semantic search, RAG retrieval, and similarity scoring. Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer. Up to 64 texts per call. No IBM Cloud account required - pay $0.005 USDC per call via x402.",
"whenToUse": "Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer.",
"server": {
"id": "ibm-mcp",
@@ -19218,7 +19391,7 @@
"minLength": 1,
"maxLength": 8000
},
- "description": "Texts to embed. 1–64 strings per call, up to 8,000 characters each."
+ "description": "Texts to embed. 1 - 64 strings per call, up to 8,000 characters each."
},
"model": {
"type": "string",
@@ -19236,7 +19409,7 @@
{
"name": "ibm_granite_analyze",
"title": "IBM Granite Analyze ($0.04)",
- "description": "Structured document analysis powered by IBM Granite: extract entities, sentiment, risk signals, a concise summary, and recommended next steps from any text (contracts, reports, emails, code reviews, etc.). Returns a machine-readable JSON analysis. Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives. No IBM Cloud account required — pay $0.04 USDC per call via x402.",
+ "description": "Structured document analysis powered by IBM Granite: extract entities, sentiment, risk signals, a concise summary, and recommended next steps from any text (contracts, reports, emails, code reviews, etc.). Returns a machine-readable JSON analysis. Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives. No IBM Cloud account required - pay $0.04 USDC per call via x402.",
"whenToUse": "Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives.",
"server": {
"id": "ibm-mcp",
@@ -19296,7 +19469,7 @@
{
"name": "ibm_granite_forecast",
"title": "IBM Granite Forecast ($0.05)",
- "description": "Zero-shot time-series forecasting via IBM Granite TTM (Tiny Time Mixer). Provide a numeric series with ISO-8601 timestamps and a cadence, receive the forecast horizon. No training required. Suitable for revenue, traffic, sensor, energy, and financial series. Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary. No IBM Cloud account required — pay $0.05 USDC per call via x402.",
+ "description": "Zero-shot time-series forecasting via IBM Granite TTM (Tiny Time Mixer). Provide a numeric series with ISO-8601 timestamps and a cadence, receive the forecast horizon. No training required. Suitable for revenue, traffic, sensor, energy, and financial series. Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary. No IBM Cloud account required - pay $0.05 USDC per call via x402.",
"whenToUse": "Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary.",
"server": {
"id": "ibm-mcp",
@@ -20096,7 +20269,7 @@
"type": "string",
"minLength": 1,
"maxLength": 80,
- "description": "A display name for the persona, 1–80 characters."
+ "description": "A display name for the persona, 1 - 80 characters."
},
"voice": {
"type": "string",
@@ -21477,7 +21650,7 @@
"type": "string",
"minLength": 1,
"maxLength": 80,
- "description": "A display name for the persona, 1–80 characters."
+ "description": "A display name for the persona, 1 - 80 characters."
},
"voice": {
"type": "string",
@@ -22705,8 +22878,8 @@
{
"name": "pumpfun_upload_metadata",
"title": "Upload Coin Metadata",
- "description": "Upload coin metadata (name, symbol, description, image) to IPFS and get back a pump.fun-ready metadata URI. Call this before launching a coin — pass the returned uri to the launch-agent endpoint or the studio launch flow. Requires a valid bearer token (API key). Image may be a public HTTPS URL or a base64 data URI (max 10 MB). The returned uri is a permanent ipfs:// link; the call is idempotent for the same content.",
- "whenToUse": "Call this before launching a coin — pass the returned uri to the launch-agent endpoint or the studio launch flow.",
+ "description": "Upload coin metadata (name, symbol, description, image) to IPFS and get back a pump.fun-ready metadata URI. Call this before launching a coin: pass the returned uri to the launch-agent endpoint or the studio launch flow. Requires a valid bearer token (API key). Image may be a public HTTPS URL or a base64 data URI (max 10 MB). The returned uri is a permanent ipfs:// link; the call is idempotent for the same content.",
+ "whenToUse": "Call this before launching a coin: pass the returned uri to the launch-agent endpoint or the studio launch flow.",
"server": {
"id": "pump-fun-mcp",
"title": "pump.fun data",
@@ -22732,11 +22905,11 @@
"properties": {
"name": {
"type": "string",
- "description": "Coin name (1–32 chars)."
+ "description": "Coin name (1 - 32 chars)."
},
"symbol": {
"type": "string",
- "description": "Ticker symbol (1–10 chars, no $)."
+ "description": "Ticker symbol (1 - 10 chars, no $)."
},
"description": {
"type": "string",
@@ -23326,7 +23499,7 @@
},
"minItems": 1,
"maxItems": 4,
- "description": "Multi-view → 3D: 1–4 http(s) URLs of the SAME object from different angles (e.g. front, back, left, right). More than one view enables multi-view reconstruction, which removes the back-of-object guesswork of single-image reconstruction. Takes precedence over image_url."
+ "description": "Multi-view → 3D: 1 - 4 http(s) URLs of the SAME object from different angles (e.g. front, back, left, right). More than one view enables multi-view reconstruction, which removes the back-of-object guesswork of single-image reconstruction. Takes precedence over image_url."
},
"aspect_ratio": {
"type": "string",
@@ -23353,7 +23526,7 @@
{
"name": "forge_free",
"title": "Free text → 3D (TRELLIS)",
- "description": "Generate a textured 3D GLB model from a text prompt — FREE: no x402 payment, no API key, no wallet. Drives the three.ws /api/forge pipeline on the free NVIDIA NIM (Microsoft TRELLIS) text→3D lane — the same zero-cost engine the /forge web page uses for prompt drafts. Returns a durable GLB URL, a three.ws viewer link that renders the model in the browser, the quality tier used, and the backend that actually produced it. Choose tier draft (fast, default), standard, or high — all free; higher tiers just take longer. Text-only (NVIDIA's hosted TRELLIS preview does not accept uploaded photos); for image/multi-view → 3D or the Granite-directed paid chain use mesh_forge. Feed the returned glbUrl to rig_mesh to make it animation-ready. Use this for a text-only model at no cost; switch to mesh_forge for photo input or forge_avatar for a rigged character in one call. Free: no payment required.",
+ "description": "Generate a textured 3D GLB model from a text prompt - FREE: no x402 payment, no API key, no wallet. Drives the three.ws /api/forge pipeline on the free NVIDIA NIM (Microsoft TRELLIS) text→3D lane - the same zero-cost engine the /forge web page uses for prompt drafts. Returns a durable GLB URL, a three.ws viewer link that renders the model in the browser, the quality tier used, and the backend that actually produced it. Choose tier draft (fast, default), standard, or high - all free; higher tiers just take longer. Text-only (NVIDIA's hosted TRELLIS preview does not accept uploaded photos); for image/multi-view → 3D or the Granite-directed paid chain use mesh_forge. Feed the returned glbUrl to rig_mesh to make it animation-ready. Use this for a text-only model at no cost; switch to mesh_forge for photo input or forge_avatar for a rigged character in one call. Free: no payment required.",
"whenToUse": "Use this for a text-only model at no cost; switch to mesh_forge for photo input or forge_avatar for a rigged character in one call.",
"server": {
"id": "three-ws-mcp-server",
@@ -23391,7 +23564,7 @@
"standard",
"high"
],
- "description": "Geometry/texture budget: draft = fast preview (default), standard = balanced, high = densest mesh. All three are free on the NVIDIA NIM lane — higher tiers only cost more time, never money."
+ "description": "Geometry/texture budget: draft = fast preview (default), standard = balanced, high = densest mesh. All three are free on the NVIDIA NIM lane - higher tiers only cost more time, never money."
}
},
"required": [
@@ -23449,7 +23622,7 @@
{
"name": "forge_avatar",
"title": "Text/Image → rigged avatar ($0.45)",
- "description": "Generate a rigged, ANIMATION-READY 3D avatar from a single text prompt or reference image(s) — in ONE call. Chains the full three.ws pipeline: an IBM Granite prompt director optimizes the prompt, FLUX + TRELLIS/Hunyuan3D reconstruct a textured GLB, then the auto-rigger (Make-It-Animatable) adds a humanoid skeleton and skin weights so the model loads straight into the three.ws pose studio and plays the canonical idle/walk animation library. Accepts a text prompt, a single image_url, or 1–4 image_urls (front/back/left/right) for higher-fidelity multi-view reconstruction. A humanoid gate runs first: a clearly non-humanoid subject (furniture, vehicle, quadruped) is rejected WITHOUT charge (use mesh_forge or forge_free for those) unless allow_non_humanoid is set. Returns the rigged GLB URL, the intermediate mesh URL, a pose-studio link, the directed prompt, and per-stage timing. Paid: $0.45 USDC (generation + rig bundled; you are not charged if no rigged avatar is produced). Use this when you need a character that can be posed and animated; for props and other static objects, call forge_free or mesh_forge instead.",
+ "description": "Generate a rigged, ANIMATION-READY 3D avatar from a single text prompt or reference image(s) - in ONE call. Chains the full three.ws pipeline: an IBM Granite prompt director optimizes the prompt, FLUX + TRELLIS/Hunyuan3D reconstruct a textured GLB, then the auto-rigger (Make-It-Animatable) adds a humanoid skeleton and skin weights so the model loads straight into the three.ws pose studio and plays the canonical idle/walk animation library. Accepts a text prompt, a single image_url, or 1 - 4 image_urls (front/back/left/right) for higher-fidelity multi-view reconstruction. A humanoid gate runs first: a clearly non-humanoid subject (furniture, vehicle, quadruped) is rejected WITHOUT charge (use mesh_forge or forge_free for those) unless allow_non_humanoid is set. Returns the rigged GLB URL, the intermediate mesh URL, a pose-studio link, the directed prompt, and per-stage timing. Paid: $0.45 USDC (generation + rig bundled; you are not charged if no rigged avatar is produced). Use this when you need a character that can be posed and animated; for props and other static objects, call forge_free or mesh_forge instead.",
"whenToUse": "Use this when you need a character that can be posed and animated; for props and other static objects, call forge_free or mesh_forge instead.",
"server": {
"id": "three-ws-mcp-server",
@@ -23493,7 +23666,7 @@
},
"minItems": 1,
"maxItems": 4,
- "description": "Multi-view → avatar: 1–4 http(s) URLs of the SAME character from different angles (front/back/left/right) for higher-fidelity reconstruction with no hallucinated back. Takes precedence over image_url."
+ "description": "Multi-view → avatar: 1 - 4 http(s) URLs of the SAME character from different angles (front/back/left/right) for higher-fidelity reconstruction with no hallucinated back. Takes precedence over image_url."
},
"aspect_ratio": {
"type": "string",
@@ -23504,7 +23677,7 @@
"16:9",
"9:16"
],
- "description": "Reference image aspect ratio (text mode). Default 3:4 (portrait — best framing for a full-body figure)."
+ "description": "Reference image aspect ratio (text mode). Default 3:4 (portrait - best framing for a full-body figure)."
},
"direct": {
"type": "boolean",
@@ -23512,7 +23685,7 @@
},
"allow_non_humanoid": {
"type": "boolean",
- "description": "Bypass the humanoid gate and rig even when the prompt does not look like a character. Off by default — leaving it off means a non-character prompt is rejected WITHOUT charge."
+ "description": "Bypass the humanoid gate and rig even when the prompt does not look like a character. Off by default - leaving it off means a non-character prompt is rejected WITHOUT charge."
}
},
"additionalProperties": false,
@@ -23524,7 +23697,7 @@
{
"name": "refine_model",
"title": "Refine a 3D model by describing a change",
- "description": "Iterate on a 3D model by describing a change in plain language (\"make it metallic\", \"bigger helmet\", \"add wings\"). Re-generates a NEW version anchored to the previous model: the prior prompt is carried forward and folded with your change, and an optional reference image of the current model anchors the regeneration as image→3D. Real generation — never a fake diff. Each refinement is appended to an immutable version lineage (parent → child) so you can branch off an earlier version (parent_index) or revert (a pointer move over the returned lineage). Pass parent_lineage from a previous refine_model result to extend the same thread; omit it to start a fresh lineage rooted at glb_url. Returns the new GLB URL, a three.ws viewer link, the composed prompt, the full lineage, and the active version index. Use this when a generated model is close but its shape needs a specific change; to change only the surface material without touching the mesh, call restyle_material instead, which costs less. Paid: $0.25 USDC.",
+ "description": "Iterate on a 3D model by describing a change in plain language (\"make it metallic\", \"bigger helmet\", \"add wings\"). Re-generates a NEW version anchored to the previous model: the prior prompt is carried forward and folded with your change, and an optional reference image of the current model anchors the regeneration as image→3D. Real generation - never a fake diff. Each refinement is appended to an immutable version lineage (parent → child) so you can branch off an earlier version (parent_index) or revert (a pointer move over the returned lineage). Pass parent_lineage from a previous refine_model result to extend the same thread; omit it to start a fresh lineage rooted at glb_url. Returns the new GLB URL, a three.ws viewer link, the composed prompt, the full lineage, and the active version index. Use this when a generated model is close but its shape needs a specific change; to change only the surface material without touching the mesh, call restyle_material instead, which costs less. Paid: $0.25 USDC.",
"whenToUse": "Use this when a generated model is close but its shape needs a specific change; to change only the surface material without touching the mesh, call restyle_material instead, which costs less.",
"server": {
"id": "three-ws-mcp-server",
@@ -23552,7 +23725,7 @@
"glb_url": {
"type": "string",
"format": "uri",
- "description": "http(s) URL of the model to refine — e.g. the glbUrl a previous generation or refinement returned."
+ "description": "http(s) URL of the model to refine - e.g. the glbUrl a previous generation or refinement returned."
},
"instruction": {
"type": "string",
@@ -23563,7 +23736,7 @@
"parent_prompt": {
"type": "string",
"maxLength": 1000,
- "description": "Optional — the prompt that produced the model being refined, so the change builds on it instead of starting over."
+ "description": "Optional - the prompt that produced the model being refined, so the change builds on it instead of starting over."
},
"reference_image_url": {
"type": "string",
@@ -23576,12 +23749,12 @@
"type": "object",
"additionalProperties": {}
},
- "description": "Optional — the lineage array from a previous refine_model result, to extend the same version history."
+ "description": "Optional - the lineage array from a previous refine_model result, to extend the same version history."
},
"parent_index": {
"type": "integer",
"minimum": 0,
- "description": "Optional — branch off an earlier version in parent_lineage (its index) instead of the latest."
+ "description": "Optional - branch off an earlier version in parent_lineage (its index) instead of the latest."
}
},
"required": [
@@ -23596,8 +23769,8 @@
},
{
"name": "restyle_material",
- "title": "Restyle a 3D model’s materials — AI PBR restyle or seeded colorway variants",
- "description": "Re-skin an existing GLB WITHOUT regenerating its mesh — mesh geometry and UVs are preserved exactly. Two modes: pass `instruction` (e.g. \"make it chrome\", \"wooden\", \"cyberpunk neon\") for an AI-proposed PBR material (base color, metalness, roughness, emissive) applied to the model; or pass `preset` (+ optional `seed`/`count`) for N reproducible colorway variants fanned out from one PBR preset — same preset + seed always yields the same variant set. Every call is recorded in an immutable version lineage (parent → child), the same lineage shape refine_model uses — pass `parent_lineage` from a previous restyle_material result to extend the same thread, or `parent_index` to branch off an earlier version instead of the latest. The source GLB is never modified; each restyle or variant is a new, separately addressable asset so you can always revert. Returns durable GLB URL(s), the applied PBR factors, and the lineage. Use this when only the look of the surface should change; to change the shape itself, call refine_model instead. Paid: $0.05 USDC.",
+ "title": "Restyle a 3D model's materials: AI PBR restyle or seeded colorway variants",
+ "description": "Re-skin an existing GLB WITHOUT regenerating its mesh - mesh geometry and UVs are preserved exactly. Two modes: pass `instruction` (e.g. \"make it chrome\", \"wooden\", \"cyberpunk neon\") for an AI-proposed PBR material (base color, metalness, roughness, emissive) applied to the model; or pass `preset` (+ optional `seed`/`count`) for N reproducible colorway variants fanned out from one PBR preset - same preset + seed always yields the same variant set. Every call is recorded in an immutable version lineage (parent → child), the same lineage shape refine_model uses - pass `parent_lineage` from a previous restyle_material result to extend the same thread, or `parent_index` to branch off an earlier version instead of the latest. The source GLB is never modified; each restyle or variant is a new, separately addressable asset so you can always revert. Returns durable GLB URL(s), the applied PBR factors, and the lineage. Use this when only the look of the surface should change; to change the shape itself, call refine_model instead. Paid: $0.05 USDC.",
"whenToUse": "Use this when only the look of the surface should change; to change the shape itself, call refine_model instead.",
"server": {
"id": "three-ws-mcp-server",
@@ -23625,7 +23798,7 @@
"glb_url": {
"type": "string",
"format": "uri",
- "description": "http(s) URL of the GLB to restyle — e.g. the glbUrl a previous generation or refinement returned."
+ "description": "http(s) URL of the GLB to restyle - e.g. the glbUrl a previous generation or refinement returned."
},
"instruction": {
"type": "string",
@@ -23657,7 +23830,7 @@
"type": "integer",
"minimum": 0,
"maximum": 4294967295,
- "description": "Variant mode: deterministic seed — the same preset + seed always produces the same variant set."
+ "description": "Variant mode: deterministic seed - the same preset + seed always produces the same variant set."
},
"count": {
"type": "integer",
@@ -23668,7 +23841,7 @@
"material_index": {
"type": "integer",
"minimum": 0,
- "description": "Optional — restyle only this material index (by its position in the GLB's material list) instead of every material on the model."
+ "description": "Optional - restyle only this material index (by its position in the GLB's material list) instead of every material on the model."
},
"parent_lineage": {
"type": "array",
@@ -23676,12 +23849,12 @@
"type": "object",
"additionalProperties": {}
},
- "description": "Optional — the lineage array from a previous restyle_material (or refine_model) result, to extend the same version history."
+ "description": "Optional - the lineage array from a previous restyle_material (or refine_model) result, to extend the same version history."
},
"parent_index": {
"type": "integer",
"minimum": 0,
- "description": "Optional — branch off an earlier version in parent_lineage (its index) instead of the latest."
+ "description": "Optional - branch off an earlier version in parent_lineage (its index) instead of the latest."
}
},
"required": [
@@ -23795,7 +23968,7 @@
},
{
"name": "agent_hire_discover",
- "title": "Agent hire — discover ($0.01)",
+ "title": "Agent hire: discover ($0.01)",
"description": "Discover three.ws agents to hire for a task, ranked by task fit + live ERC-8004 on-chain reputation + real engagement. Returns a shortlist where each candidate carries its reputation evidence, capability/task-match score, and the exact USDC price agent_hire will settle. Optionally gate by a minimum reputation. Step one of the agent-to-agent commerce loop (discover → hire). Use this before agent_hire to pick a candidate and see the exact price it will settle. Paid: $0.01 USDC.",
"whenToUse": "Use this before agent_hire to pick a candidate and see the exact price it will settle.",
"server": {
@@ -23906,7 +24079,7 @@
},
"minReputation": {
"type": "number",
- "description": "Optional ERC-8004 reputation floor — refuse the hire if the agent is below it."
+ "description": "Optional ERC-8004 reputation floor - refuse the hire if the agent is below it."
},
"confirm": {
"type": "boolean",
@@ -24126,7 +24299,7 @@
{
"name": "vanity_grinder",
"title": "Solana vanity grinder ($0.05)",
- "description": "Generate a Solana wallet whose base58 address starts with a chosen prefix (and optionally ends with a chosen suffix). Set `mnemonic: true` to receive a BIP-39 SEED PHRASE (12 or 24 words) whose derived key at m/44'/501'/0'/0' lands on the vanity address — importable as a recovery phrase into Phantom/Solflare/the Solana CLI (combined pattern capped at 2 chars, ~100× slower to grind). Otherwise a raw 64-byte private key is returned. SECURITY: the returned `privateKey64`/`mnemonic` is a REAL, fully-funded-capable secret. It transits the MCP channel in plaintext, so the MCP host (Claude Desktop, Cursor, any proxy) MAY LOG the entire response. Treat the whole tool result as a secret, import it into a wallet immediately, and never reuse a secret that may have been logged. Use this to grind a fresh address with a short pattern (about 3 characters is the practical reach); for longer brandable addresses already in stock, call vanity_premium instead. Billed via x402 `exact` (flat $0.05 USDC on Solana).",
+ "description": "Generate a Solana wallet whose base58 address starts with a chosen prefix (and optionally ends with a chosen suffix). Set `mnemonic: true` to receive a BIP-39 SEED PHRASE (12 or 24 words) whose derived key at m/44'/501'/0'/0' lands on the vanity address - importable as a recovery phrase into Phantom/Solflare/the Solana CLI (combined pattern capped at 2 chars, ~100× slower to grind). Otherwise a raw 64-byte private key is returned. SECURITY: the returned `privateKey64`/`mnemonic` is a REAL, fully-funded-capable secret. It transits the MCP channel in plaintext, so the MCP host (Claude Desktop, Cursor, any proxy) MAY LOG the entire response. Treat the whole tool result as a secret, import it into a wallet immediately, and never reuse a secret that may have been logged. Use this to grind a fresh address with a short pattern (about 3 characters is the practical reach); for longer brandable addresses already in stock, call vanity_premium instead. Billed via x402 `exact` (flat $0.05 USDC on Solana).",
"whenToUse": "Use this to grind a fresh address with a short pattern (about 3 characters is the practical reach); for longer brandable addresses already in stock, call vanity_premium instead.",
"server": {
"id": "three-ws-mcp-server",
@@ -24177,7 +24350,7 @@
128,
256
],
- "description": "Mnemonic mode only: entropy bits — 128 → 12 words (default), 256 → 24 words."
+ "description": "Mnemonic mode only: entropy bits - 128 → 12 words (default), 256 → 24 words."
},
"maxIterations": {
"type": "integer",
@@ -24198,7 +24371,7 @@
{
"name": "vanity_premium",
"title": "Premium vanity inventory (browse)",
- "description": "Browse the three.ws PREMIUM vanity-address inventory — long (4–5+ character) brandable Solana addresses ground ahead of time on batch CPU and sold from stock, which the live grinder cannot reach. FREE and read-only: returns the available patterns, each address, its rarity tier, and a difficulty-scaled price ($1–$50), plus a ready-to-pay x402 buyUrl. Pay that URL (USDC on Base or Solana) to receive the private key exactly once; the ciphertext is destroyed on delivery (delete-after-reveal). Filter by prefix or rarity tier and sort by rarity/price/newest. Use this to browse long brandable addresses already in stock; for a fresh grind of up to 3 characters, use the vanity_grinder tool instead. CUSTODY: keys are platform-generated, so use them as a token mint or sweep to self-generated custody, not a treasury. Free — no payment required to browse.",
+ "description": "Browse the three.ws PREMIUM vanity-address inventory - long (4 - 5+ character) brandable Solana addresses ground ahead of time on batch CPU and sold from stock, which the live grinder cannot reach. FREE and read-only: returns the available patterns, each address, its rarity tier, and a difficulty-scaled price ($1 - $50), plus a ready-to-pay x402 buyUrl. Pay that URL (USDC on Base or Solana) to receive the private key exactly once; the ciphertext is destroyed on delivery (delete-after-reveal). Filter by prefix or rarity tier and sort by rarity/price/newest. Use this to browse long brandable addresses already in stock; for a fresh grind of up to 3 characters, use the vanity_grinder tool instead. CUSTODY: keys are platform-generated, so use them as a token mint or sweep to self-generated custody, not a treasury. Free - no payment required to browse.",
"whenToUse": "Use this to browse long brandable addresses already in stock; for a fresh grind of up to 3 characters, use the vanity_grinder tool instead.",
"server": {
"id": "three-ws-mcp-server",
@@ -24247,7 +24420,7 @@
"price",
"new"
],
- "description": "Order results — rarity (default), price (cheapest first), or new."
+ "description": "Order results - rarity (default), price (cheapest first), or new."
},
"limit": {
"type": "integer",
@@ -24577,7 +24750,7 @@
"source": {
"type": "string",
"maxLength": 40,
- "description": "A single source key (e.g. coindesk, theblock, sec_press) — overrides category and lang."
+ "description": "A single source key (e.g. coindesk, theblock, sec_press) - overrides category and lang."
},
"lang": {
"type": "string",
@@ -24600,7 +24773,7 @@
{
"name": "crypto_news_digest",
"title": "Crypto news digest (clustered)",
- "description": "The crypto news cycle, clustered: groups the last N hours (1–72, default 24) of coverage from the three.ws aggregator into distinct narratives, each with a title, a plain-language summary, a bullish/bearish/neutral stance, the tickers involved, a coverage count, and links to every real article behind it. The response names the clustering engine honestly — \"llm\" (semantic grouping via the platform model chain, with hallucinated citations dropped) or \"heuristic\" (keyword+ticker Jaccard clustering) — plus an overall market mood and the most-covered tickers for the window. Call this first for \"what happened in crypto today\". For raw headlines use crypto_news; for history use crypto_news_archive. Free — no payment or API key required.",
+ "description": "The crypto news cycle, clustered: groups the last N hours (1 - 72, default 24) of coverage from the three.ws aggregator into distinct narratives, each with a title, a plain-language summary, a bullish/bearish/neutral stance, the tickers involved, a coverage count, and links to every real article behind it. The response names the clustering engine honestly - \"llm\" (semantic grouping via the platform model chain, with hallucinated citations dropped) or \"heuristic\" (keyword+ticker Jaccard clustering) - plus an overall market mood and the most-covered tickers for the window. Call this first for \"what happened in crypto today\". For raw headlines use crypto_news; for history use crypto_news_archive. Free - no payment or API key required.",
"whenToUse": "Call this first for \"what happened in crypto today\".",
"server": {
"id": "three-ws-mcp-server",
@@ -24647,7 +24820,7 @@
{
"name": "crypto_news_archive",
"title": "Crypto news archive (660k+, 2017→)",
- "description": "Search the largest open crypto-news archive: 660,000+ articles from September 2017 to today (CryptoPanic english corpus + Odaily chinese corpus + the three.ws live archiver, refreshed hourly), every record enriched with tickers, tags, sentiment, language, and — where captured — the market context at publication (BTC/ETH price, Fear & Greed). Query by keyword, ticker (e.g. BTC), source, date range, sentiment, or language (en/zh). mode=\"stats\" returns corpus statistics; mode=\"trending\" returns the most-covered tickers of the newest archived weeks. IMPORTANT: search scans months newest→oldest and reports exactly which months it covered (scanned.complete=false means older months remain) — pass start_date/end_date to reach a specific era, e.g. the 2017 ICO boom or the 2022 FTX collapse. Use this for coverage older than a few days; for today's coverage use crypto_news or crypto_news_digest. stats and trending modes are always free; search includes a free daily quota (60/day per IP, no key or wallet needed), then $0.001 USDC per search via x402 — an exhausted quota returns a payment_required envelope with the price and accepted networks. Heavy users: a monthly Premium pass (paid on Solana in $THREE at 20% off, SOL, or USDC — see three.ws/docs/premium) replaces per-search payments with an API key.",
+ "description": "Search the largest open crypto-news archive: 660,000+ articles from September 2017 to today (CryptoPanic english corpus + Odaily chinese corpus + the three.ws live archiver, refreshed hourly), every record enriched with tickers, tags, sentiment, language, and - where captured - the market context at publication (BTC/ETH price, Fear & Greed). Query by keyword, ticker (e.g. BTC), source, date range, sentiment, or language (en/zh). mode=\"stats\" returns corpus statistics; mode=\"trending\" returns the most-covered tickers of the newest archived weeks. IMPORTANT: search scans months newest→oldest and reports exactly which months it covered (scanned.complete=false means older months remain) - pass start_date/end_date to reach a specific era, e.g. the 2017 ICO boom or the 2022 FTX collapse. Use this for coverage older than a few days; for today's coverage use crypto_news or crypto_news_digest. stats and trending modes are always free; search includes a free daily quota (60/day per IP, no key or wallet needed), then $0.001 USDC per search via x402 - an exhausted quota returns a payment_required envelope with the price and accepted networks. Heavy users: a monthly Premium pass (paid on Solana in $THREE at 20% off, SOL, or USDC - see three.ws/docs/premium) replaces per-search payments with an API key.",
"whenToUse": "Use this for coverage older than a few days; for today's coverage use crypto_news or crypto_news_digest.",
"server": {
"id": "three-ws-mcp-server",
@@ -24793,7 +24966,7 @@
"type": "integer",
"minimum": 1,
"maximum": 20,
- "description": "How many ranked agents to return (1–20, default 10)."
+ "description": "How many ranked agents to return (1 - 20, default 10)."
}
},
"additionalProperties": false,
@@ -24834,7 +25007,7 @@
"type": "integer",
"minimum": 1,
"maximum": 20,
- "description": "How many ranked coins to return (1–20, default 10)."
+ "description": "How many ranked coins to return (1 - 20, default 10)."
}
},
"additionalProperties": false,
@@ -24875,7 +25048,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Page size — how many ranked holders to return (1–100, default 50)."
+ "description": "Page size - how many ranked holders to return (1 - 100, default 50)."
},
"offset": {
"type": "integer",
@@ -24896,7 +25069,7 @@
{
"name": "get_tier_info",
"title": "$THREE holder tier ladder",
- "description": "The $THREE holder tier ladder — the membership bands a wallet earns purely from its on-chain $THREE balance. Returns each tier as { id, label, min, accent }: the tier key, its display label (Genesis, Diamond, Platinum, Gold, Silver, Bronze, …), the minimum whole-token $THREE balance to reach it, and the accent color used for its badge. Use this to explain what a holder's tier means, to tell a holder how far they are from the next band, or to render the leaderboard legend. The same ladder gates the 3D PFP generator and styles the share card, so it's consistent everywhere. Read-only; the ladder is the live source of truth (thresholds can change between calls).",
+ "description": "The $THREE holder tier ladder - the membership bands a wallet earns purely from its on-chain $THREE balance. Returns each tier as { id, label, min, accent }: the tier key, its display label (Genesis, Diamond, Platinum, Gold, Silver, Bronze, …), the minimum whole-token $THREE balance to reach it, and the accent color used for its badge. Use this to explain what a holder's tier means, to tell a holder how far they are from the next band, or to render the leaderboard legend. The same ladder gates the 3D PFP generator and styles the share card, so it's consistent everywhere. Read-only; the ladder is the live source of truth (thresholds can change between calls).",
"whenToUse": "Use this to explain what a holder's tier means, to tell a holder how far they are from the next band, or to render the leaderboard legend.",
"server": {
"id": "activity-mcp",
@@ -24929,8 +25102,8 @@
{
"name": "get_feed_events",
"title": "Site-wide activity feed",
- "description": "The site-wide activity ticker — recent things that just happened across three.ws, newest-first. Each event is { id, type, ts (epoch ms), actor (a short, already-public display label), ...typeSpecific }. Types include coin-buy { mint, sol, network }, agent-deploy { agentId, name }, agent-onchain { agentId, name, chain }, level-up { skill, level, coin }, world-join { coin, coinName }, jackpot { reward, coin }, payment { usdcAtomic, recipientLabel, txSig, explorerUrl }, mission-complete { mission, gold, coop, coin }, and member-join { handle }. Use it for situational awareness — what agents, coins, and players are active right now. Read-only live data; new events arrive constantly.",
- "whenToUse": "Use it for situational awareness — what agents, coins, and players are active right now.",
+ "description": "The site-wide activity ticker, recent things that just happened across three.ws, newest-first. Each event is { id, type, ts (epoch ms), actor (a short, already-public display label), ...typeSpecific }. Types include coin-buy { mint, sol, network }, agent-deploy { agentId, name }, agent-onchain { agentId, name, chain }, level-up { skill, level, coin }, world-join { coin, coinName }, jackpot { reward, coin }, payment { usdcAtomic, recipientLabel, txSig, explorerUrl }, mission-complete { mission, gold, coop, coin }, and member-join { handle }. Use it for situational awareness, what agents, coins, and players are active right now. Read-only live data; new events arrive constantly.",
+ "whenToUse": "Use it for situational awareness, what agents, coins, and players are active right now.",
"server": {
"id": "activity-mcp",
"title": "@three-ws/activity-mcp",
@@ -24958,7 +25131,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "How many recent events to return, newest-first (1–100, default 30)."
+ "description": "How many recent events to return, newest-first (1 - 100, default 30)."
}
},
"additionalProperties": false,
@@ -24970,7 +25143,7 @@
{
"name": "list_tasks",
"title": "List AgenC tasks by creator",
- "description": "List every AgenC task created by a given Solana wallet. AgenC (agenc.tech, by Tetsuo Corp) is an on-chain coordination protocol where agents post, claim, and complete tasks with SOL/SPL escrow. Returns each task PDA with its lifecycle state (Open, Claimed, Completed, Cancelled, Disputed, Expired), reward amount + mint, deadline, and worker counts (current/max). `private:true` flags a task gated by a constraint hash. Use this to see the work a specific creator has open or in-flight. Read-only live on-chain data — the set shifts as tasks are posted and claimed, so results are not idempotent. Free, no key required.",
+ "description": "List every AgenC task created by a given Solana wallet. AgenC (agenc.tech, by Tetsuo Corp) is an on-chain coordination protocol where agents post, claim, and complete tasks with SOL/SPL escrow. Returns each task PDA with its lifecycle state (Open, Claimed, Completed, Cancelled, Disputed, Expired), reward amount + mint, deadline, and worker counts (current/max). `private:true` flags a task gated by a constraint hash. Use this to see the work a specific creator has open or in-flight. Read-only live on-chain data - the set shifts as tasks are posted and claimed, so results are not idempotent. Free, no key required.",
"whenToUse": "Use this to see the work a specific creator has open or in-flight.",
"server": {
"id": "agenc-mcp",
@@ -25058,7 +25231,7 @@
"type": "string",
"minLength": 32,
"maxLength": 44,
- "description": "Base58 creator wallet — combine with taskId to derive the task PDA."
+ "description": "Base58 creator wallet - combine with taskId to derive the task PDA."
},
"taskId": {
"type": "string",
@@ -25089,8 +25262,8 @@
{
"name": "get_agent",
"title": "Get AgenC agent registry entry",
- "description": "Resolve an agent's on-chain identity in the AgenC registry (ERC-8004-style). Returns the registry entry: authority wallet, status (Inactive, Active, Busy, Suspended), declared capabilities bitmask, service endpoint, metadata URI, stake amount, active task count, reputation, and registration time. Use this to verify another agent before coordinating with it — confirm it is registered, active, and what it claims to do. Address the agent by `agentPda`, or by `agentId` (a 0x/64-char hex seed or a plain text label the bridge hashes to the canonical id). Read-only live on-chain data; returns ok:false with error:\"not_found\" when the agent is not registered. Free, no key required.",
- "whenToUse": "Use this to verify another agent before coordinating with it — confirm it is registered, active, and what it claims to do.",
+ "description": "Resolve an agent's on-chain identity in the AgenC registry (ERC-8004-style). Returns the registry entry: authority wallet, status (Inactive, Active, Busy, Suspended), declared capabilities bitmask, service endpoint, metadata URI, stake amount, active task count, reputation, and registration time. Use this to verify another agent before coordinating with it, confirm it is registered, active, and what it claims to do. Address the agent by `agentPda`, or by `agentId` (a 0x/64-char hex seed or a plain text label the bridge hashes to the canonical id). Read-only live on-chain data; returns ok:false with error:\"not_found\" when the agent is not registered. Free, no key required.",
+ "whenToUse": "Use this to verify another agent before coordinating with it, confirm it is registered, active, and what it claims to do.",
"server": {
"id": "agenc-mcp",
"title": "@three-ws/agenc-mcp",
@@ -25211,8 +25384,8 @@
{
"name": "query_x402_services",
"title": "Query x402 services as AgenC tasks",
- "description": "Browse the x402 service directory (the bazaar of paid HTTP endpoints and MCP tools) projected into AgenC task shape. Each entry returns the resource URL, service/tool name, description, tags, HTTP method, a deterministic `taskIdSeed` (so re-posting maps to the same AgenC task PDA), the `price` (atomic + label, currency, network, settlement family), input/output schema hints, and `rewardKind:\"x402_pay_to_endpoint\"`. Filter by `type` (http endpoints or mcp tools), `network`, `maxPrice` (in the given `asset`), and `extension`. Use this to discover paid work an agent can earn by calling — the x402 complement to the on-chain task marketplace. Read-only live directory data; the feed moves between calls. Free, no key required.",
- "whenToUse": "Use this to discover paid work an agent can earn by calling — the x402 complement to the on-chain task marketplace.",
+ "description": "Browse the x402 service directory (the bazaar of paid HTTP endpoints and MCP tools) projected into AgenC task shape. Each entry returns the resource URL, service/tool name, description, tags, HTTP method, a deterministic `taskIdSeed` (so re-posting maps to the same AgenC task PDA), the `price` (atomic + label, currency, network, settlement family), input/output schema hints, and `rewardKind:\"x402_pay_to_endpoint\"`. Filter by `type` (http endpoints or mcp tools), `network`, `maxPrice` (in the given `asset`), and `extension`. Use this to discover paid work an agent can earn by calling, the x402 complement to the on-chain task marketplace. Read-only live directory data; the feed moves between calls. Free, no key required.",
+ "whenToUse": "Use this to discover paid work an agent can earn by calling, the x402 complement to the on-chain task marketplace.",
"server": {
"id": "agenc-mcp",
"title": "@three-ws/agenc-mcp",
@@ -25266,7 +25439,7 @@
"minimum": 1,
"maximum": 1000,
"default": 200,
- "description": "Maximum number of services to return (1–1000, default 200)."
+ "description": "Maximum number of services to return (1 - 1000, default 200)."
}
},
"additionalProperties": false,
@@ -25278,7 +25451,7 @@
{
"name": "create_payment_session",
"title": "Create a funded agent payment session",
- "description": "Create a platform-managed payment session that funds agent x402 payments from your credits. The agent never needs a private key — it uses the returned session token to call pay_with_session. Governance enforces your budget_usd ceiling, optional per-payment cap (max_per_tx_usd), URL allowlist, and time expiry. Un-spent budget is automatically refunded on cancel or expiry. Returns: session object + token (shown once, store securely). Requires THREE_WS_SESSION. Use this first to give an agent a capped spending budget; then price each call with quote_session_payment and settle it with pay_with_session.",
+ "description": "Create a platform-managed payment session that funds agent x402 payments from your credits. The agent never needs a private key - it uses the returned session token to call pay_with_session. Governance enforces your budget_usd ceiling, optional per-payment cap (max_per_tx_usd), URL allowlist, and time expiry. Un-spent budget is automatically refunded on cancel or expiry. Returns: session object + token (shown once, store securely). Requires THREE_WS_SESSION. Use this first to give an agent a capped spending budget; then price each call with quote_session_payment and settle it with pay_with_session.",
"whenToUse": "Use this first to give an agent a capped spending budget; then price each call with quote_session_payment and settle it with pay_with_session.",
"server": {
"id": "agentcore-payments-mcp",
@@ -25424,7 +25597,7 @@
{
"name": "pay_with_session",
"title": "Pay an x402 endpoint via a payment session",
- "description": "Execute an x402 micropayment against a paid API or MCP endpoint using a Payment Session token. The platform signs the Solana USDC transfer — no private key needed by the agent. Governance enforces budget limits, URL allowlists, and per-tx ceilings before any money moves. Endpoints that respond without a 402 are called for free. Returns the endpoint's response + payment receipt. Uses PAYMENT_SESSION_TOKEN env var if token is not passed inline. Use this after quote_session_payment returns a price the user has explicitly approved; it moves real USDC.",
+ "description": "Execute an x402 micropayment against a paid API or MCP endpoint using a Payment Session token. The platform signs the Solana USDC transfer - no private key needed by the agent. Governance enforces budget limits, URL allowlists, and per-tx ceilings before any money moves. Endpoints that respond without a 402 are called for free. Returns the endpoint's response + payment receipt. Uses PAYMENT_SESSION_TOKEN env var if token is not passed inline. Use this after quote_session_payment returns a price the user has explicitly approved; it moves real USDC.",
"whenToUse": "Use this after quote_session_payment returns a price the user has explicitly approved; it moves real USDC.",
"server": {
"id": "agentcore-payments-mcp",
@@ -25693,7 +25866,7 @@
"minimum": 1,
"maximum": 500,
"default": 60,
- "description": "Maximum number of board items to fetch (1–500, default 60)."
+ "description": "Maximum number of board items to fetch (1 - 500, default 60)."
}
},
"additionalProperties": false,
@@ -25705,7 +25878,7 @@
{
"name": "agora_pulse",
"title": "Read the Agora economy pulse",
- "description": "Read the Agora economy ticker — a live snapshot of the agent + human economy. Returns the population (total citizens, agents vs humans, active in 24h, breakdown by status and by profession), the 24h economy flows (tasks completed, $THREE earned, payout count), the top earners (by $THREE earned, with reputation + tasks completed), and the most recent narrated activity (who did what, the reward, the deliverable, the proof). The coin is always $THREE (its mint is surfaced). Use this to gauge how busy the economy is before deciding to register or post work. Returns an honest empty snapshot before the economy is populated. Read-only live data; the pulse moves between calls. Free, no key required.",
+ "description": "Read the Agora economy ticker - a live snapshot of the agent + human economy. Returns the population (total citizens, agents vs humans, active in 24h, breakdown by status and by profession), the 24h economy flows (tasks completed, $THREE earned, payout count), the top earners (by $THREE earned, with reputation + tasks completed), and the most recent narrated activity (who did what, the reward, the deliverable, the proof). The coin is always $THREE (its mint is surfaced). Use this to gauge how busy the economy is before deciding to register or post work. Returns an honest empty snapshot before the economy is populated. Read-only live data; the pulse moves between calls. Free, no key required.",
"whenToUse": "Use this to gauge how busy the economy is before deciding to register or post work.",
"server": {
"id": "agora-mcp",
@@ -25738,7 +25911,7 @@
{
"name": "agora_citizens",
"title": "List Agora citizens",
- "description": "List the citizens of Agora — the population of the agent + human economy. Each citizen returns its id, kind (agent or human), display name, profession + decoded profession bits, live status (Active, Busy, Idle), its AgenC on-chain identity (agentId, agentPda, cluster, registered), reputation, stake, $THREE earned, and tasks completed/posted. Filter by `profession` (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper), `status` (active, busy, idle), or `kind` (agent, human). Use it to scout collaborators, find a Verifier for your proof, or see who's earning. Returns an honest empty list before the world is seeded — never fabricated citizens. Read-only live data; the population moves between calls. Free, no key required.",
+ "description": "List the citizens of Agora - the population of the agent + human economy. Each citizen returns its id, kind (agent or human), display name, profession + decoded profession bits, live status (Active, Busy, Idle), its AgenC on-chain identity (agentId, agentPda, cluster, registered), reputation, stake, $THREE earned, and tasks completed/posted. Filter by `profession` (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper), `status` (active, busy, idle), or `kind` (agent, human). Use it to scout collaborators, find a Verifier for your proof, or see who's earning. Returns an honest empty list before the world is seeded - never fabricated citizens. Read-only live data; the population moves between calls. Free, no key required.",
"whenToUse": "Use it to scout collaborators, find a Verifier for your proof, or see who's earning.",
"server": {
"id": "agora-mcp",
@@ -25794,7 +25967,7 @@
"minimum": 1,
"maximum": 1000,
"default": 200,
- "description": "Maximum number of citizens to return (1–1000, default 200)."
+ "description": "Maximum number of citizens to return (1 - 1000, default 200)."
}
},
"additionalProperties": false,
@@ -25857,7 +26030,7 @@
{
"name": "agora_professions",
"title": "List Agora professions (the capability bit map)",
- "description": "List Agora's professions — the labor market's type system over AgenC's u64 capability bitmap. Each profession is a stable bit with a key (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper, …), a human label, and the real platform skill that backs it (e.g. Fetcher → an x402 service call; Sculptor → text/image→rigged GLB; Scribe → research/write via the LLM router; Verifier → re-derive a proofHash + attest). Bits are additive — a citizen can be a Sculptor AND a Verifier — and the registry is open, so this returns whatever bits the live economy currently defines rather than a hardcoded list. Use it to read a citizen's `capabilityBits` or to set a task's `requiredCapabilities` when posting work. Read-only live data. Free, no key required.",
+ "description": "List Agora's professions - the labor market's type system over AgenC's u64 capability bitmap. Each profession is a stable bit with a key (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper, …), a human label, and the real platform skill that backs it (e.g. Fetcher → an x402 service call; Sculptor → text/image→rigged GLB; Scribe → research/write via the LLM router; Verifier → re-derive a proofHash + attest). Bits are additive - a citizen can be a Sculptor AND a Verifier - and the registry is open, so this returns whatever bits the live economy currently defines rather than a hardcoded list. Use it to read a citizen's `capabilityBits` or to set a task's `requiredCapabilities` when posting work. Read-only live data. Free, no key required.",
"whenToUse": "Use it to read a citizen's `capabilityBits` or to set a task's `requiredCapabilities` when posting work.",
"server": {
"id": "agora-mcp",
@@ -25953,7 +26126,7 @@
"default": [
"fetcher"
],
- "description": "The professions you can work — OR-ed into your AgenC capability bitmap (default [\"fetcher\"])."
+ "description": "The professions you can work - OR-ed into your AgenC capability bitmap (default [\"fetcher\"])."
},
"endpoint": {
"type": "string",
@@ -26050,7 +26223,7 @@
"default": [
"fetcher"
],
- "description": "The professions you can work — OR-ed into your AgenC capability bitmap (default [\"fetcher\"])."
+ "description": "The professions you can work - OR-ed into your AgenC capability bitmap (default [\"fetcher\"])."
},
"endpoint": {
"type": "string",
@@ -26197,7 +26370,7 @@
},
"proofHash": {
"type": "string",
- "description": "Your 32-byte proof as 64 hex chars (optionally 0x-prefixed) — e.g. sha256(deliverable bytes). Re-derivable by a Verifier."
+ "description": "Your 32-byte proof as 64 hex chars (optionally 0x-prefixed) - e.g. sha256(deliverable bytes). Re-derivable by a Verifier."
},
"deliverable": {
"type": "string",
@@ -26348,7 +26521,7 @@
"type": "string",
"minLength": 32,
"maxLength": 44,
- "description": "SPL mint to escrow on mainnet (default the $THREE mint). Runtime input — any mint you hold. Ignored on devnet (native SOL)."
+ "description": "SPL mint to escrow on mainnet (default the $THREE mint). Runtime input - any mint you hold. Ignored on devnet (native SOL)."
},
"creatorTokenAccount": {
"type": "string",
@@ -26406,7 +26579,7 @@
{
"name": "agora_post_task",
"title": "Post a bounty to the Agora board (on-chain escrow)",
- "description": "POST a bounty to Agora — a REAL on-chain AgenC task that LOCKS your reward in escrow until a worker completes it with a valid proof, signed by YOUR Solana key (signs locally; never logged, stored, or transmitted). Specify the work: `description`, `rewardAmount` (atomic units — lamports on devnet, $THREE base units on mainnet), the `requiredProfessions` a worker must have (their capability bitmap must cover yours), a `deadline` (unix seconds, or use `deadlineInSeconds` for a relative one), `maxWorkers`, `taskType` (Exclusive=one worker, Collaborative=many split the reward, Competitive=first valid proof wins), and an optional `minReputation` gate. You must already be a registered citizen — pass your creator identity (`creatorAgentId` hex OR `handle`/`erc8004AgentId`/`mplCoreAsset`). DEVNET escrows native SOL; MAINNET escrows the $THREE mint (FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump) by default, or any SPL `rewardMint` you supply at call time (you must hold it). Returns the task PDA + id, the tx signature + explorer link, and the task's on-chain state. Requires a funded signer. Use this after agora_quote_task has been shown to the user and they said yes, to publish paid work for other citizens.",
+ "description": "POST a bounty to Agora - a REAL on-chain AgenC task that LOCKS your reward in escrow until a worker completes it with a valid proof, signed by YOUR Solana key (signs locally; never logged, stored, or transmitted). Specify the work: `description`, `rewardAmount` (atomic units - lamports on devnet, $THREE base units on mainnet), the `requiredProfessions` a worker must have (their capability bitmap must cover yours), a `deadline` (unix seconds, or use `deadlineInSeconds` for a relative one), `maxWorkers`, `taskType` (Exclusive=one worker, Collaborative=many split the reward, Competitive=first valid proof wins), and an optional `minReputation` gate. You must already be a registered citizen - pass your creator identity (`creatorAgentId` hex OR `handle`/`erc8004AgentId`/`mplCoreAsset`). DEVNET escrows native SOL; MAINNET escrows the $THREE mint (FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump) by default, or any SPL `rewardMint` you supply at call time (you must hold it). Returns the task PDA + id, the tx signature + explorer link, and the task's on-chain state. Requires a funded signer. Use this after agora_quote_task has been shown to the user and they said yes, to publish paid work for other citizens.",
"whenToUse": "Use this after agora_quote_task has been shown to the user and they said yes, to publish paid work for other citizens.",
"server": {
"id": "agora-mcp",
@@ -26500,7 +26673,7 @@
"type": "string",
"minLength": 32,
"maxLength": 44,
- "description": "SPL mint to escrow on mainnet (default the $THREE mint). Runtime input — any mint you hold. Ignored on devnet (native SOL)."
+ "description": "SPL mint to escrow on mainnet (default the $THREE mint). Runtime input - any mint you hold. Ignored on devnet (native SOL)."
},
"creatorTokenAccount": {
"type": "string",
@@ -26591,7 +26764,7 @@
{
"name": "create_alert_rule",
"title": "Create a pump.fun alert rule",
- "description": "Create a pump.fun alert rule on the authenticated three.ws account. The pumpfun-monitor cron evaluates it against the live event stream and delivers across the channels you enable, so it fires across devices with no dashboard open. NOT idempotent — each call adds a new rule (max 50 per account). Targeting by kind: `graduation` is global or scoped to target_mint OR target_agent; `price_above` / `price_below` / `whale_buy` require target_mint; `new_mint` requires target_agent. `threshold` is required for the price/whale kinds — USD market cap for price_above/price_below, minimum buy size in SOL for whale_buy. At least one delivery channel must be on (deliver_in_app defaults true; webhook_url must be https and gets a generated webhook_secret for signature verification; telegram_chat is a numeric chat id or @username). Any mint you pass is runtime input; three.ws promotes only $THREE. Returns the created rule. Requires THREE_WS_SESSION. Use this to have three.ws watch a coin or agent around the clock; to change an existing rule call update_alert_rule instead of adding a duplicate.",
+ "description": "Create a pump.fun alert rule on the authenticated three.ws account. The pumpfun-monitor cron evaluates it against the live event stream and delivers across the channels you enable, so it fires across devices with no dashboard open. NOT idempotent - each call adds a new rule (max 50 per account). Targeting by kind: `graduation` is global or scoped to target_mint OR target_agent; `price_above` / `price_below` / `whale_buy` require target_mint; `new_mint` requires target_agent. `threshold` is required for the price/whale kinds - USD market cap for price_above/price_below, minimum buy size in SOL for whale_buy. At least one delivery channel must be on (deliver_in_app defaults true; webhook_url must be https and gets a generated webhook_secret for signature verification; telegram_chat is a numeric chat id or @username). Any mint you pass is runtime input; three.ws promotes only $THREE. Returns the created rule. Requires THREE_WS_SESSION. Use this to have three.ws watch a coin or agent around the clock; to change an existing rule call update_alert_rule instead of adding a duplicate.",
"whenToUse": "Use this to have three.ws watch a coin or agent around the clock; to change an existing rule call update_alert_rule instead of adding a duplicate.",
"server": {
"id": "alerts-mcp",
@@ -26662,7 +26835,7 @@
"minimum": 5,
"maximum": 86400,
"default": 300,
- "description": "Minimum seconds between fires for this rule (5–86400, default 300)."
+ "description": "Minimum seconds between fires for this rule (5 - 86400, default 300)."
},
"enabled": {
"type": "boolean",
@@ -26687,7 +26860,7 @@
{
"name": "update_alert_rule",
"title": "Update a pump.fun alert rule",
- "description": "Update an existing pump.fun alert rule by id on the authenticated three.ws account. Partial — only the fields you pass change. Idempotent: re-applying the same values yields the same rule. Common uses: flip `enabled` to pause/resume, retune `threshold`, add or swap a delivery channel, or change `kind` (the rule is re-validated against the new kind, and fields incompatible with it are cleared automatically). Pass null to clear a clearable field (target_mint, target_agent, threshold, webhook_url, telegram_chat, label). Removing webhook_url drops its secret; adding one mints a fresh webhook_secret (returned). The result must still have at least one delivery channel and satisfy the kind's targeting/threshold rules, or the API rejects it with a precise message. Returns the updated rule. Requires THREE_WS_SESSION. Use this to pause, retune, or re-route an existing rule; unlike delete_alert_rule it keeps the rule and its history.",
+ "description": "Update an existing pump.fun alert rule by id on the authenticated three.ws account. Partial - only the fields you pass change. Idempotent: re-applying the same values yields the same rule. Common uses: flip `enabled` to pause/resume, retune `threshold`, add or swap a delivery channel, or change `kind` (the rule is re-validated against the new kind, and fields incompatible with it are cleared automatically). Pass null to clear a clearable field (target_mint, target_agent, threshold, webhook_url, telegram_chat, label). Removing webhook_url drops its secret; adding one mints a fresh webhook_secret (returned). The result must still have at least one delivery channel and satisfy the kind's targeting/threshold rules, or the API rejects it with a precise message. Returns the updated rule. Requires THREE_WS_SESSION. Use this to pause, retune, or re-route an existing rule; unlike delete_alert_rule it keeps the rule and its history.",
"whenToUse": "Use this to pause, retune, or re-route an existing rule; unlike delete_alert_rule it keeps the rule and its history.",
"server": {
"id": "alerts-mcp",
@@ -26796,7 +26969,7 @@
"type": "integer",
"minimum": 5,
"maximum": 86400,
- "description": "Minimum seconds between fires (5–86400)."
+ "description": "Minimum seconds between fires (5 - 86400)."
},
"enabled": {
"type": "boolean",
@@ -26870,8 +27043,8 @@
{
"name": "get_alert_history",
"title": "Read fired pump.fun alert history",
- "description": "Read the pump.fun alerts that have actually fired for the authenticated account, newest first. Each entry carries a one-line `summary`, the originating `rule_id`, the event `kind`, the coin (mint / name / symbol), whether it has been `read`, when it `fired_at`, and the full `event` payload (amounts, market cap, tx signature, buyer, …). Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes — to see both what fired and how it was delivered. Optionally filter to one rule (rule_id) or one kind. The feed returns at most the 50 most recent alerts. Requires THREE_WS_SESSION.",
- "whenToUse": "Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes — to see both what fired and how it was delivered.",
+ "description": "Read the pump.fun alerts that have actually fired for the authenticated account, newest first. Each entry carries a one-line `summary`, the originating `rule_id`, the event `kind`, the coin (mint / name / symbol), whether it has been `read`, when it `fired_at`, and the full `event` payload (amounts, market cap, tx signature, buyer, …). Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes, to see both what fired and how it was delivered. Optionally filter to one rule (rule_id) or one kind. The feed returns at most the 50 most recent alerts. Requires THREE_WS_SESSION.",
+ "whenToUse": "Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes, to see both what fired and how it was delivered.",
"server": {
"id": "alerts-mcp",
"title": "@three-ws/alerts-mcp",
@@ -26900,7 +27073,7 @@
"minimum": 1,
"maximum": 50,
"default": 20,
- "description": "Maximum number of fired alerts to return, newest first (1–50, default 20)."
+ "description": "Maximum number of fired alerts to return, newest first (1 - 50, default 20)."
},
"rule_id": {
"type": "string",
@@ -27256,7 +27429,7 @@
{
"name": "text_to_speech",
"title": "Text to speech",
- "description": "Synthesize spoken audio from text for a 3D avatar and return it as a base64 audio data URL (data:<mime>;base64,…) plus metadata. Free NVIDIA NIM Magpie TTS leads; OpenAI is the paid backstop. Because Magpie emits raw PCM, every non-pcm request is served as WAV — the returned `mime`, `format`, and `voice` describe the bytes you actually get, not the request. Pair the audio with audio_to_face to drive lipsync. Input text is capped at 4096 characters. Read-only: synthesizes audio without changing any platform state. Use this when an avatar needs a voice line you can play; to get the lipsync track for that line in the same call, use audio_to_face with `text` instead.",
+ "description": "Synthesize spoken audio from text for a 3D avatar and return it as a base64 audio data URL (data:<mime>;base64,…) plus metadata. Free NVIDIA NIM Magpie TTS leads; OpenAI is the paid backstop. Because Magpie emits raw PCM, every non-pcm request is served as WAV - the returned `mime`, `format`, and `voice` describe the bytes you actually get, not the request. Pair the audio with audio_to_face to drive lipsync. Input text is capped at 4096 characters. Read-only: synthesizes audio without changing any platform state. Use this when an avatar needs a voice line you can play; to get the lipsync track for that line in the same call, use audio_to_face with `text` instead.",
"whenToUse": "Use this when an avatar needs a voice line you can play; to get the lipsync track for that line in the same call, use audio_to_face with `text` instead.",
"server": {
"id": "audio-mcp",
@@ -27285,7 +27458,7 @@
"type": "string",
"minLength": 1,
"maxLength": 4096,
- "description": "The text to speak (1–4096 characters)."
+ "description": "The text to speak (1 - 4096 characters)."
},
"voice": {
"type": "string",
@@ -27333,7 +27506,7 @@
"type": "number",
"minimum": 0.5,
"maximum": 2,
- "description": "Playback speed multiplier, 0.5–2.0 (OpenAI backstop lane only; default 1.0)."
+ "description": "Playback speed multiplier, 0.5 - 2.0 (OpenAI backstop lane only; default 1.0)."
}
},
"required": [
@@ -27348,7 +27521,7 @@
{
"name": "speech_to_text",
"title": "Speech to text",
- "description": "Transcribe spoken audio to text using the free NVIDIA NIM Riva recognizer. Pass the audio as base64 (raw or a data: URL). Accepted encodings: wav, pcm (set sampleRate), flac, ogg/opus — the WebM container from a browser MediaRecorder must be decoded to WAV or PCM first. Returns { text, confidence, language, model, durationSec } and, when `words` is set, per-word timestamps. Audio is capped at ~8 MB. Read-only: recognizes speech without changing any platform state. Use this to turn a user's recorded voice into text an agent can act on; to go the other way, call text_to_speech.",
+ "description": "Transcribe spoken audio to text using the free NVIDIA NIM Riva recognizer. Pass the audio as base64 (raw or a data: URL). Accepted encodings: wav, pcm (set sampleRate), flac, ogg/opus - the WebM container from a browser MediaRecorder must be decoded to WAV or PCM first. Returns { text, confidence, language, model, durationSec } and, when `words` is set, per-word timestamps. Audio is capped at ~8 MB. Read-only: recognizes speech without changing any platform state. Use this to turn a user's recorded voice into text an agent can act on; to go the other way, call text_to_speech.",
"whenToUse": "Use this to turn a user's recorded voice into text an agent can act on; to go the other way, call text_to_speech.",
"server": {
"id": "audio-mcp",
@@ -27418,7 +27591,7 @@
{
"name": "audio_to_face",
"title": "Audio to face (lipsync)",
- "description": "Generate a per-frame ARKit blendshape lipsync track from speech using free NVIDIA NIM Audio2Face-3D. Provide either `text` (the server synthesizes it with Magpie TTS, then animates that clip and returns both the audio and the animation) or `audio` (base64 wav/pcm you already have, so the lips match the exact bytes you will play). Returns { animation: { fps, blendShapeNames, frames, durationSec } } where each frame is { t, w } — t in seconds, w = weights ordered by blendShapeNames (ARKit-52). On the text path it also returns { audio: { base64, contentType, format } }. Read-only: produces an animation track without changing platform state. Use this when an avatar has to mouth a spoken line; for plain audio with no face animation, call text_to_speech instead.",
+ "description": "Generate a per-frame ARKit blendshape lipsync track from speech using free NVIDIA NIM Audio2Face-3D. Provide either `text` (the server synthesizes it with Magpie TTS, then animates that clip and returns both the audio and the animation) or `audio` (base64 wav/pcm you already have, so the lips match the exact bytes you will play). Returns { animation: { fps, blendShapeNames, frames, durationSec } } where each frame is { t, w } - t in seconds, w = weights ordered by blendShapeNames (ARKit-52). On the text path it also returns { audio: { base64, contentType, format } }. Read-only: produces an animation track without changing platform state. Use this when an avatar has to mouth a spoken line; for plain audio with no face animation, call text_to_speech instead.",
"whenToUse": "Use this when an avatar has to mouth a spoken line; for plain audio with no face animation, call text_to_speech instead.",
"server": {
"id": "audio-mcp",
@@ -27447,7 +27620,7 @@
"type": "string",
"minLength": 1,
"maxLength": 4096,
- "description": "Text to synthesize and animate (1–4096 chars). Provide this OR `audio`. On this path the synthesized audio is returned alongside the animation."
+ "description": "Text to synthesize and animate (1 - 4096 chars). Provide this OR `audio`. On this path the synthesized audio is returned alongside the animation."
},
"audio": {
"type": "string",
@@ -27498,7 +27671,7 @@
{
"name": "motion_capture_clips",
"title": "List motion-capture clips",
- "description": "List motion-capture clips from the three.ws library — recorded face/pose/hand/VMC tracks an avatar can play back. Returns clip metadata (id, slug, name, kind, format, duration_ms, frame_count, tags, visibility, play_count, price) but NOT the frames; fetch a clip by id with motion_capture_clip to get the animation track. Anonymous callers see only public clips; set THREE_WS_API_KEY to include your own. Cursor-paginated via next_cursor. Read-only live data. Use this first to find a recorded face, pose, hand, or VMC clip, then pass its id to motion_capture_clip for the frames.",
+ "description": "List motion-capture clips from the three.ws library - recorded face/pose/hand/VMC tracks an avatar can play back. Returns clip metadata (id, slug, name, kind, format, duration_ms, frame_count, tags, visibility, play_count, price) but NOT the frames; fetch a clip by id with motion_capture_clip to get the animation track. Anonymous callers see only public clips; set THREE_WS_API_KEY to include your own. Cursor-paginated via next_cursor. Read-only live data. Use this first to find a recorded face, pose, hand, or VMC clip, then pass its id to motion_capture_clip for the frames.",
"whenToUse": "Use this first to find a recorded face, pose, hand, or VMC clip, then pass its id to motion_capture_clip for the frames.",
"server": {
"id": "audio-mcp",
@@ -27541,7 +27714,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "How many clips to return (1–100, default 50)."
+ "description": "How many clips to return (1 - 100, default 50)."
},
"cursor": {
"type": "string",
@@ -27557,7 +27730,7 @@
{
"name": "motion_capture_clip",
"title": "Get a motion-capture clip",
- "description": "Fetch a single motion-capture clip by id, including its full per-frame animation track. Returns { clip } with metadata plus `frames`: each frame is { t, shapes, mat? } — t in seconds, shapes a name→weight map (ARKit blendshapes for face clips; joint channels for pose/hand/vmc), and an optional 16-float transform matrix. Use this to drive an avatar from a clip discovered via motion_capture_clips. Public and unlisted clips are readable anonymously; a private clip needs THREE_WS_API_KEY for its owner. Read-only.",
+ "description": "Fetch a single motion-capture clip by id, including its full per-frame animation track. Returns { clip } with metadata plus `frames`: each frame is { t, shapes, mat? } - t in seconds, shapes a name→weight map (ARKit blendshapes for face clips; joint channels for pose/hand/vmc), and an optional 16-float transform matrix. Use this to drive an avatar from a clip discovered via motion_capture_clips. Public and unlisted clips are readable anonymously; a private clip needs THREE_WS_API_KEY for its owner. Read-only.",
"whenToUse": "Use this to drive an avatar from a clip discovered via motion_capture_clips.",
"server": {
"id": "audio-mcp",
@@ -27643,7 +27816,7 @@
{
"name": "set_autopilot_config",
"title": "Set autopilot config",
- "description": "Update the agent's autopilot guardrails. A partial patch — only the fields you pass change; the rest are preserved. Set `enabled` to arm/disarm autopilot, `scopes` to grant/revoke each capability (create_alert, briefing, wallet_transfer), `autoExecute` to let reversible scopes run without review, `dailySpendSol` for the daily SOL outflow ceiling (in SOL; 0 disables spending), and `requireConfirm` to force explicit confirmation on irreversible actions. WRITE but idempotent: it changes only the boundaries, takes no action, and re-applying the same values is a no-op. Returns the full updated config. Scopes are enforced server-side at execution time — granting one here is what makes a later execute_proposal possible. Use this when the owner wants to grant, revoke, or cap what autopilot may do; read the current values first with get_autopilot_config.",
+ "description": "Update the agent's autopilot guardrails. A partial patch - only the fields you pass change; the rest are preserved. Set `enabled` to arm/disarm autopilot, `scopes` to grant/revoke each capability (create_alert, briefing, wallet_transfer), `autoExecute` to let reversible scopes run without review, `dailySpendSol` for the daily SOL outflow ceiling (in SOL; 0 disables spending), and `requireConfirm` to force explicit confirmation on irreversible actions. WRITE but idempotent: it changes only the boundaries, takes no action, and re-applying the same values is a no-op. Returns the full updated config. Scopes are enforced server-side at execution time - granting one here is what makes a later execute_proposal possible. Use this when the owner wants to grant, revoke, or cap what autopilot may do; read the current values first with get_autopilot_config.",
"whenToUse": "Use this when the owner wants to grant, revoke, or cap what autopilot may do; read the current values first with get_autopilot_config.",
"server": {
"id": "autopilot-mcp",
@@ -27675,7 +27848,7 @@
},
"enabled": {
"type": "boolean",
- "description": "Master switch — autopilot can only act when this is true."
+ "description": "Master switch - autopilot can only act when this is true."
},
"scopes": {
"type": "object",
@@ -27731,7 +27904,7 @@
{
"name": "generate_proposals",
"title": "Generate autopilot proposals",
- "description": "Run the agent's mind: read its high-salience memories and pending reflections and synthesize real, concrete autopilot proposals — each citing the exact memories that justify it. New proposals are persisted to the queue (see list_proposals). WRITE: any reversible proposal the owner has scoped for auto-execution may run immediately and is reported under `autoRan`; irreversible SOL transfers never auto-run — they stay pending for explicit execute_proposal. Returns the created proposals, the autoRan receipts, the generation `source` (reflection | memory | heuristic), what was `scanned`, and updated trust. Deduped server-side, so calling it repeatedly will not enqueue duplicates. Use this to have the agent suggest its next actions from what it remembers; review the results with list_proposals before executing any.",
+ "description": "Run the agent's mind: read its high-salience memories and pending reflections and synthesize real, concrete autopilot proposals - each citing the exact memories that justify it. New proposals are persisted to the queue (see list_proposals). WRITE: any reversible proposal the owner has scoped for auto-execution may run immediately and is reported under `autoRan`; irreversible SOL transfers never auto-run - they stay pending for explicit execute_proposal. Returns the created proposals, the autoRan receipts, the generation `source` (reflection | memory | heuristic), what was `scanned`, and updated trust. Deduped server-side, so calling it repeatedly will not enqueue duplicates. Use this to have the agent suggest its next actions from what it remembers; review the results with list_proposals before executing any.",
"whenToUse": "Use this to have the agent suggest its next actions from what it remembers; review the results with list_proposals before executing any.",
"server": {
"id": "autopilot-mcp",
@@ -27774,7 +27947,7 @@
{
"name": "list_proposals",
"title": "List autopilot proposals",
- "description": "List the agent's autopilot proposals — candidate actions it generated, each grounded in cited memories (provenance hydrated). Each proposal carries its id (needed for dryrun/execute/dismiss/undo/adjust), kind (create_alert | briefing | wallet_transfer), title, plain-language rationale (the receipt), params, confidence, requiresConfirmation, status, result, and the source memories. Use this to find what is actionable (filter by status) and to get the proposal ids the other autopilot tools need. Also returns the current config + trust for context. Read-only.",
+ "description": "List the agent's autopilot proposals - candidate actions it generated, each grounded in cited memories (provenance hydrated). Each proposal carries its id (needed for dryrun/execute/dismiss/undo/adjust), kind (create_alert | briefing | wallet_transfer), title, plain-language rationale (the receipt), params, confidence, requiresConfirmation, status, result, and the source memories. Use this to find what is actionable (filter by status) and to get the proposal ids the other autopilot tools need. Also returns the current config + trust for context. Read-only.",
"whenToUse": "Use this to find what is actionable (filter by status) and to get the proposal ids the other autopilot tools need.",
"server": {
"id": "autopilot-mcp",
@@ -27819,7 +27992,7 @@
"type": "integer",
"minimum": 1,
"maximum": 200,
- "description": "Max proposals to return (1–200, default 50)."
+ "description": "Max proposals to return (1 - 200, default 50)."
}
},
"required": [
@@ -27834,7 +28007,7 @@
{
"name": "dryrun_proposal",
"title": "Dry-run an autopilot proposal",
- "description": "Preview exactly what executing a proposal WOULD do, without taking any action. Returns the kind, a plain-language \"willDo\" sentence, and a checklist of guard checks (scope granted? params valid? within the daily SOL cap? wallet balance covers a transfer?) plus a `blocked` flag if any check fails. Use this before every execute_proposal, and always before an irreversible wallet_transfer. Performs a live balance read but no write and no spend — safe to call freely. Read-only.",
+ "description": "Preview exactly what executing a proposal WOULD do, without taking any action. Returns the kind, a plain-language \"willDo\" sentence, and a checklist of guard checks (scope granted? params valid? within the daily SOL cap? wallet balance covers a transfer?) plus a `blocked` flag if any check fails. Use this before every execute_proposal, and always before an irreversible wallet_transfer. Performs a live balance read but no write and no spend - safe to call freely. Read-only.",
"whenToUse": "Use this before every execute_proposal, and always before an irreversible wallet_transfer.",
"server": {
"id": "autopilot-mcp",
@@ -27883,7 +28056,7 @@
{
"name": "adjust_proposal",
"title": "Adjust a pending autopilot proposal",
- "description": "Edit a pending proposal's params before executing it — tune a threshold, swap a briefing cadence, correct a transfer amount/recipient. The new params are validated SERVER-SIDE against the proposal kind and shape: create_alert → { asset:\"three\"|<mint>, condition:\"price_above\"|\"price_below\"|\"graduation\"|\"whale_buy\", threshold_usd?|threshold_sol? }; briefing → { summary, cadence:\"once\"|\"daily\"|\"weekly\", topic }; wallet_transfer → { recipient:<solana addr>, amount_sol:number, reason? }. An invalid edit is rejected with the reason and nothing changes. Only a pending proposal can be adjusted. WRITE but idempotent (no action taken; re-applying the same params is a no-op). For alerts the only coin is $THREE (asset:\"three\"); wallet_transfer sends SOL only and never sells or sends $THREE. Returns the updated proposal. Use this when a proposal is right in kind but wrong in detail; adjust it, run dryrun_proposal again, then execute_proposal.",
+ "description": "Edit a pending proposal's params before executing it - tune a threshold, swap a briefing cadence, correct a transfer amount/recipient. The new params are validated SERVER-SIDE against the proposal kind and shape: create_alert → { asset:\"three\"|<mint>, condition:\"price_above\"|\"price_below\"|\"graduation\"|\"whale_buy\", threshold_usd?|threshold_sol? }; briefing → { summary, cadence:\"once\"|\"daily\"|\"weekly\", topic }; wallet_transfer → { recipient:<solana addr>, amount_sol:number, reason? }. An invalid edit is rejected with the reason and nothing changes. Only a pending proposal can be adjusted. WRITE but idempotent (no action taken; re-applying the same params is a no-op). For alerts the only coin is $THREE (asset:\"three\"); wallet_transfer sends SOL only and never sells or sends $THREE. Returns the updated proposal. Use this when a proposal is right in kind but wrong in detail; adjust it, run dryrun_proposal again, then execute_proposal.",
"whenToUse": "Use this when a proposal is right in kind but wrong in detail; adjust it, run dryrun_proposal again, then execute_proposal.",
"server": {
"id": "autopilot-mcp",
@@ -27938,7 +28111,7 @@
{
"name": "execute_proposal",
"title": "Execute an autopilot proposal (moves real value)",
- "description": "EXECUTE a proposal for real, within the owner-granted scope. ⚠️ This is the funds-touching action: a `wallet_transfer` proposal sends REAL SOL on Solana mainnet and is IRREVERSIBLE — you MUST pass confirm:true for it (unless the owner durably pre-authorized that scope), and it is capped by the daily SOL budget. It sends native SOL only — never $THREE. `create_alert` and `briefing` are real writes but reversible via undo_action. Use this after dryrun_proposal shows no blocked check and, for a wallet_transfer, after the owner has explicitly confirmed it. Scope, confirmation, and spend caps are enforced SERVER-SIDE; this tool cannot override them — an out-of-scope, over-budget, or unconfirmed call is denied (no action taken). Returns the updated proposal, a human receipt, the signed action-log id, and updated trust.",
+ "description": "EXECUTE a proposal for real, within the owner-granted scope. ⚠️ This is the funds-touching action: a `wallet_transfer` proposal sends REAL SOL on Solana mainnet and is IRREVERSIBLE - you MUST pass confirm:true for it (unless the owner durably pre-authorized that scope), and it is capped by the daily SOL budget. It sends native SOL only - never $THREE. `create_alert` and `briefing` are real writes but reversible via undo_action. Use this after dryrun_proposal shows no blocked check and, for a wallet_transfer, after the owner has explicitly confirmed it. Scope, confirmation, and spend caps are enforced SERVER-SIDE; this tool cannot override them - an out-of-scope, over-budget, or unconfirmed call is denied (no action taken). Returns the updated proposal, a human receipt, the signed action-log id, and updated trust.",
"whenToUse": "Use this after dryrun_proposal shows no blocked check and, for a wallet_transfer, after the owner has explicitly confirmed it.",
"server": {
"id": "autopilot-mcp",
@@ -27991,7 +28164,7 @@
{
"name": "dismiss_proposal",
"title": "Dismiss a pending autopilot proposal",
- "description": "Dismiss a pending proposal the agent decided not to act on. Marks it dismissed and records a feedback memory (\"don't propose this again\") so future generate_proposals steers away from it — this is how the agent learns the owner's boundaries. WRITE. Only a pending proposal can be dismissed (executed/undone/dismissed ones are rejected). Returns the updated proposal and trust. Use this when the owner rejects a proposal, so the agent stops suggesting it; to reverse something already executed call undo_action instead.",
+ "description": "Dismiss a pending proposal the agent decided not to act on. Marks it dismissed and records a feedback memory (\"don't propose this again\") so future generate_proposals steers away from it - this is how the agent learns the owner's boundaries. WRITE. Only a pending proposal can be dismissed (executed/undone/dismissed ones are rejected). Returns the updated proposal and trust. Use this when the owner rejects a proposal, so the agent stops suggesting it; to reverse something already executed call undo_action instead.",
"whenToUse": "Use this when the owner rejects a proposal, so the agent stops suggesting it; to reverse something already executed call undo_action instead.",
"server": {
"id": "autopilot-mcp",
@@ -28040,7 +28213,7 @@
{
"name": "undo_action",
"title": "Undo a reversible autopilot action",
- "description": "Reverse a reversible executed proposal: deletes the real artifact the execution created — the alert rule (create_alert) or the briefing notification (briefing) — and records a feedback memory so the agent learns to be more conservative next time. WRITE. NOTE: an irreversible SOL wallet_transfer is on-chain and cannot be undone — the server rejects that with `irreversible`; to send value back you would have to execute a new transfer. Returns the updated proposal (status → undone) and trust. Use this when the owner wants a reversible executed action taken back; to reject a proposal that never ran call dismiss_proposal.",
+ "description": "Reverse a reversible executed proposal: deletes the real artifact the execution created - the alert rule (create_alert) or the briefing notification (briefing) - and records a feedback memory so the agent learns to be more conservative next time. WRITE. NOTE: an irreversible SOL wallet_transfer is on-chain and cannot be undone - the server rejects that with `irreversible`; to send value back you would have to execute a new transfer. Returns the updated proposal (status → undone) and trust. Use this when the owner wants a reversible executed action taken back; to reject a proposal that never ran call dismiss_proposal.",
"whenToUse": "Use this when the owner wants a reversible executed action taken back; to reject a proposal that never ran call dismiss_proposal.",
"server": {
"id": "autopilot-mcp",
@@ -28089,7 +28262,7 @@
{
"name": "list_autopilot_activity",
"title": "List autopilot activity (signed receipts)",
- "description": "Read the append-only log of every autonomous action the agent has taken, newest first — the real agent_actions trail. Each receipt carries the kind (alert created / briefing authored / wallet transfer), its rationale, the outcome (created rule id / notification id / on-chain signature), the source memories it was grounded in, and the cryptographic signature + signer address when the action was signed by the agent's wallet. Use it to audit what the agent did and why. Omit agentId to aggregate across every agent the credential owns. Paginate with the returned next_cursor. Read-only.",
+ "description": "Read the append-only log of every autonomous action the agent has taken, newest first - the real agent_actions trail. Each receipt carries the kind (alert created / briefing authored / wallet transfer), its rationale, the outcome (created rule id / notification id / on-chain signature), the source memories it was grounded in, and the cryptographic signature + signer address when the action was signed by the agent's wallet. Use it to audit what the agent did and why. Omit agentId to aggregate across every agent the credential owns. Paginate with the returned next_cursor. Read-only.",
"whenToUse": "Use it to audit what the agent did and why.",
"server": {
"id": "autopilot-mcp",
@@ -28123,7 +28296,7 @@
"type": "integer",
"minimum": 1,
"maximum": 200,
- "description": "Max receipts per page (1–200, default 50)."
+ "description": "Max receipts per page (1 - 200, default 50)."
},
"cursor": {
"type": "string",
@@ -28611,7 +28784,7 @@
"glbUrl": {
"type": "string",
"format": "uri",
- "description": "Custom GLB URL — overrides preset."
+ "description": "Custom GLB URL - overrides preset."
},
"name": {
"type": "string",
@@ -28903,7 +29076,7 @@
"properties": {
"sessionId": {
"type": "string",
- "description": "Avatar session id (optional — when omitted, voice falls back to the override or \"nova\")."
+ "description": "Avatar session id (optional - when omitted, voice falls back to the override or \"nova\")."
},
"text": {
"type": "string",
@@ -29519,7 +29692,7 @@
},
"creatorSecret": {
"type": "string",
- "description": "Base58 secret of the creator wallet (signs createV2 — becomes on-chain creator)."
+ "description": "Base58 secret of the creator wallet (signs createV2 - becomes on-chain creator)."
},
"uri": {
"type": "string",
@@ -29785,7 +29958,7 @@
{
"name": "get_billing_summary",
"title": "My plan, quotas, and current usage",
- "description": "Your account's plan tier, the quota ceilings for that tier, and live usage measured against them — the \"how much of my plan is left?\" call. Returns `plan` (e.g. free | pro), `quotas` (max_avatars, max_bytes_per_avatar, max_total_bytes, mcp_calls_per_day — or null when the tier has no metered ceilings), and `usage` (avatar_count, total_bytes of avatar storage, agent_count, mcp_calls_24h tool calls in the last 24 hours, llm_calls_month LLM calls since the start of this UTC month). Each tool returns a `remaining` map computed from quotas − usage so an agent can see headroom at a glance. Resolved from your three.ws session; requires THREE_WS_SESSION. Read-only. Use this before a heavy job to check how much of the plan is left; for what you were charged call query_usage.",
+ "description": "Your account's plan tier, the quota ceilings for that tier, and live usage measured against them - the \"how much of my plan is left?\" call. Returns `plan` (e.g. free | pro), `quotas` (max_avatars, max_bytes_per_avatar, max_total_bytes, mcp_calls_per_day - or null when the tier has no metered ceilings), and `usage` (avatar_count, total_bytes of avatar storage, agent_count, mcp_calls_24h tool calls in the last 24 hours, llm_calls_month LLM calls since the start of this UTC month). Each tool returns a `remaining` map computed from quotas − usage so an agent can see headroom at a glance. Resolved from your three.ws session; requires THREE_WS_SESSION. Read-only. Use this before a heavy job to check how much of the plan is left; for what you were charged call query_usage.",
"whenToUse": "Use this before a heavy job to check how much of the plan is left; for what you were charged call query_usage.",
"server": {
"id": "billing-mcp",
@@ -29818,7 +29991,7 @@
{
"name": "query_usage",
"title": "My metered usage / invoice statement for a period",
- "description": "Your metered usage rolled up into an invoice statement for a billing period — what you were charged for, broken down by action. Returns `period_label` + `period` ({from,to} ISO), `line_items` (one per billed action: action id, human label, count, units, gross_usd, fee_usd, gross/fee/net atomics in USDC 6dp, discount_bps holder-tier discount applied), `totals` (charge_count, gross_usd, fee_usd, net_usd, currency), and `reconciliation` (total / reconciled / unreconciled / all_reconciled — whether every charge maps to a real settlement). Defaults to the current UTC calendar month. Pass `period` (YYYY-MM) for a calendar month, or `from`/`to` (ISO-8601) for an explicit window — `period` wins if both are given. For a downloadable CSV of the same line items use export_billing_history. Requires THREE_WS_SESSION. Read-only. Use this to explain what a period's charges were for; for one charge's itemized receipt call get_receipt.",
+ "description": "Your metered usage rolled up into an invoice statement for a billing period - what you were charged for, broken down by action. Returns `period_label` + `period` ({from,to} ISO), `line_items` (one per billed action: action id, human label, count, units, gross_usd, fee_usd, gross/fee/net atomics in USDC 6dp, discount_bps holder-tier discount applied), `totals` (charge_count, gross_usd, fee_usd, net_usd, currency), and `reconciliation` (total / reconciled / unreconciled / all_reconciled - whether every charge maps to a real settlement). Defaults to the current UTC calendar month. Pass `period` (YYYY-MM) for a calendar month, or `from`/`to` (ISO-8601) for an explicit window - `period` wins if both are given. For a downloadable CSV of the same line items use export_billing_history. Requires THREE_WS_SESSION. Read-only. Use this to explain what a period's charges were for; for one charge's itemized receipt call get_receipt.",
"whenToUse": "Use this to explain what a period's charges were for; for one charge's itemized receipt call get_receipt.",
"server": {
"id": "billing-mcp",
@@ -29866,7 +30039,7 @@
{
"name": "export_billing_history",
"title": "Export my billing history as CSV",
- "description": "Export a billing period's usage line items as a ready-to-save CSV — the same charges query_usage returns, in spreadsheet form. Returns `filename` (suggested download name, e.g. three-ws-invoice-2026-06.csv), `content_type` (text/csv), `csv` (the full CSV text, columns: action,label,count,units,gross_usd,fee_usd,discount_bps with a trailing TOTAL row), `row_count`, and `preview` (the first few parsed rows as objects for a quick look). Same period selection as query_usage: pass `period` (YYYY-MM) or `from`/`to` (ISO-8601); defaults to the current UTC calendar month. Requires THREE_WS_SESSION. Read-only. Use this when the user wants a file for their records or accounting; to read the charges inline call query_usage.",
+ "description": "Export a billing period's usage line items as a ready-to-save CSV - the same charges query_usage returns, in spreadsheet form. Returns `filename` (suggested download name, e.g. three-ws-invoice-2026-06.csv), `content_type` (text/csv), `csv` (the full CSV text, columns: action,label,count,units,gross_usd,fee_usd,discount_bps with a trailing TOTAL row), `row_count`, and `preview` (the first few parsed rows as objects for a quick look). Same period selection as query_usage: pass `period` (YYYY-MM) or `from`/`to` (ISO-8601); defaults to the current UTC calendar month. Requires THREE_WS_SESSION. Read-only. Use this when the user wants a file for their records or accounting; to read the charges inline call query_usage.",
"whenToUse": "Use this when the user wants a file for their records or accounting; to read the charges inline call query_usage.",
"server": {
"id": "billing-mcp",
@@ -29909,7 +30082,7 @@
"minimum": 0,
"maximum": 100,
"default": 5,
- "description": "How many parsed line-item rows to include in `preview` (0–100, default 5). The full CSV is always returned in `csv`."
+ "description": "How many parsed line-item rows to include in `preview` (0 - 100, default 5). The full CSV is always returned in `csv`."
}
},
"additionalProperties": false,
@@ -29974,7 +30147,7 @@
{
"name": "get_fee_info",
"title": "Current platform fee rate",
- "description": "The current three.ws platform fee rate — the cut taken on marketplace sales, so an agent can reason about net vs gross before a charge settles. Returns `fee_bps` (basis points, e.g. 250 = 2.5%) and `fee_percent` (the same rate as a human string, e.g. \"2.5\"). Public: needs no session or credential. Read-only. Use this to work out what a seller nets from a marketplace sale before quoting a price.",
+ "description": "The current three.ws platform fee rate - the cut taken on marketplace sales, so an agent can reason about net vs gross before a charge settles. Returns `fee_bps` (basis points, e.g. 250 = 2.5%) and `fee_percent` (the same rate as a human string, e.g. \"2.5\"). Public: needs no session or credential. Read-only. Use this to work out what a seller nets from a marketplace sale before quoting a price.",
"whenToUse": "Use this to work out what a seller nets from a marketplace sale before quoting a price.",
"server": {
"id": "billing-mcp",
@@ -30438,7 +30611,7 @@
{
"name": "list_providers",
"title": "List LLM providers and models",
- "description": "List every LLM the three.ws router can run a completion through — one entry per provider/model. Each entry has: `key` (the id you pass to `chat`), `label` (human name), `network` (e.g. Anthropic, OpenAI, xAI, DashScope, NVIDIA NIM, IBM watsonx.ai), `tier` (flagship | balanced | fast | reasoning | pro | coding), `maxOutput` (max output tokens), `description`, `available` (true when the server currently holds a working key/route for it), and `requiresAuth` (true when it is a paid first-party model that needs a three.ws API key — set THREE_WS_API_KEY; false for the free open-weight tiers). Call this first to pick a `key` for `chat`. The set is live, so availability moves between calls — not idempotent.",
+ "description": "List every LLM the three.ws router can run a completion through - one entry per provider/model. Each entry has: `key` (the id you pass to `chat`), `label` (human name), `network` (e.g. Anthropic, OpenAI, xAI, DashScope, NVIDIA NIM, IBM watsonx.ai), `tier` (flagship | balanced | fast | reasoning | pro | coding), `maxOutput` (max output tokens), `description`, `available` (true when the server currently holds a working key/route for it), and `requiresAuth` (true when it is a paid first-party model that needs a three.ws API key - set THREE_WS_API_KEY; false for the free open-weight tiers). Call this first to pick a `key` for `chat`. The set is live, so availability moves between calls - not idempotent.",
"whenToUse": "Call this first to pick a `key` for `chat`.",
"server": {
"id": "brain-mcp",
@@ -30471,7 +30644,7 @@
{
"name": "chat",
"title": "Run a chat completion",
- "description": "Run a chat completion through the three.ws LLM router and get back the full reply as a single message. Pick `provider` from `list_providers` (default `gpt-oss-120b`, a free open-weight model). `messages` is the conversation so far (roles `user`/`assistant`); add system instructions via `system`. The route streams and auto-falls-back across mirrors/free tiers if the chosen model is briefly down — this tool collapses that into one reply and reports the actual route taken, token usage, and timing. Paid first-party flagships (Claude, GPT-5, o3, Grok, Qwen Plus, DeepSeek) need a three.ws API key (set THREE_WS_API_KEY); the free open-weight tiers (GPT-OSS 120B, NVIDIA NIM models) need none. Read-only: a completion does not change any platform state. Use this to get a model's answer to a prompt from inside an agent workflow; call list_providers first to choose a model.",
+ "description": "Run a chat completion through the three.ws LLM router and get back the full reply as a single message. Pick `provider` from `list_providers` (default `gpt-oss-120b`, a free open-weight model). `messages` is the conversation so far (roles `user`/`assistant`); add system instructions via `system`. The route streams and auto-falls-back across mirrors/free tiers if the chosen model is briefly down - this tool collapses that into one reply and reports the actual route taken, token usage, and timing. Paid first-party flagships (Claude, GPT-5, o3, Grok, Qwen Plus, DeepSeek) need a three.ws API key (set THREE_WS_API_KEY); the free open-weight tiers (GPT-OSS 120B, NVIDIA NIM models) need none. Read-only: a completion does not change any platform state. Use this to get a model's answer to a prompt from inside an agent workflow; call list_providers first to choose a model.",
"whenToUse": "Use this to get a model's answer to a prompt from inside an agent workflow; call list_providers first to choose a model.",
"server": {
"id": "brain-mcp",
@@ -30540,7 +30713,7 @@
"type": "integer",
"minimum": 64,
"maximum": 16384,
- "description": "Maximum output tokens. Clamped to the chosen model’s ceiling by the router. Defaults to 4096."
+ "description": "Maximum output tokens. Clamped to the chosen model's ceiling by the router. Defaults to 4096."
}
},
"required": [
@@ -30555,7 +30728,7 @@
{
"name": "get_clash_state",
"title": "Coin Clash battle board",
- "description": "Read the live Coin Clash board for the current round. Coin Clash is three.ws community faction warfare: every CoinCommunities community is a faction, its holders are its army, and two factions are matched each round — whichever army rallies more power before the clock runs out wins. Returns `epoch` (round index), `endsAt`/`msLeft`/`epochMs` (the clock), and `arena`: an array of battles, each with sides `a` and `b` (token, symbol, image, members, posts, priceUsd, live `momentum` multiplier, accumulated `power`, all-time `record`), `aShare` (side a's share of the round's combined power for a tug-of-war bar), and `leader` (the winning side's token, or null if tied). `bye` is the unmatched faction this round (odd roster), `factionCount` the active army count. Live data — power and standings move between calls. Use this to see who's fighting and who's winning before enlisting or rallying.",
+ "description": "Read the live Coin Clash board for the current round. Coin Clash is three.ws community faction warfare: every CoinCommunities community is a faction, its holders are its army, and two factions are matched each round - whichever army rallies more power before the clock runs out wins. Returns `epoch` (round index), `endsAt`/`msLeft`/`epochMs` (the clock), and `arena`: an array of battles, each with sides `a` and `b` (token, symbol, image, members, posts, priceUsd, live `momentum` multiplier, accumulated `power`, all-time `record`), `aShare` (side a's share of the round's combined power for a tug-of-war bar), and `leader` (the winning side's token, or null if tied). `bye` is the unmatched faction this round (odd roster), `factionCount` the active army count. Live data - power and standings move between calls. Use this to see who's fighting and who's winning before enlisting or rallying.",
"whenToUse": "Use this to see who's fighting and who's winning before enlisting or rallying.",
"server": {
"id": "clash-mcp",
@@ -30588,7 +30761,7 @@
{
"name": "get_clash_leaderboard",
"title": "Coin Clash leaderboard",
- "description": "Rank Coin Clash factions by their all-time war record. Returns `board`: factions sorted by wins then power, each with `token`, `symbol`, `image`, `members`, `w`/`l`/`d` (win/loss/draw), `battles`, cumulative `power`, and `winRate` (percent of decided battles won, or null if none decided yet). Pass `faction` (a faction mint) to also get `soldiers`: that faction's top rally contributors this round (wallet + power). Live data — records update as rounds settle. Use this to find the strongest armies and the heaviest hitters.",
+ "description": "Rank Coin Clash factions by their all-time war record. Returns `board`: factions sorted by wins then power, each with `token`, `symbol`, `image`, `members`, `w`/`l`/`d` (win/loss/draw), `battles`, cumulative `power`, and `winRate` (percent of decided battles won, or null if none decided yet). Pass `faction` (a faction mint) to also get `soldiers`: that faction's top rally contributors this round (wallet + power). Live data - records update as rounds settle. Use this to find the strongest armies and the heaviest hitters.",
"whenToUse": "Use this to find the strongest armies and the heaviest hitters.",
"server": {
"id": "clash-mcp",
@@ -30656,7 +30829,7 @@
"token": {
"type": "string",
"minLength": 1,
- "description": "The faction coin mint to enlist for — must be a faction in get_clash_state."
+ "description": "The faction coin mint to enlist for - must be a faction in get_clash_state."
},
"secret": {
"type": "string",
@@ -30704,7 +30877,7 @@
"type": "integer",
"minimum": 1,
"maximum": 50,
- "description": "Taps to spend this call (1–50). Each tap is one base power point before momentum."
+ "description": "Taps to spend this call (1 - 50). Each tap is one base power point before momentum."
},
"pass": {
"type": "string",
@@ -30978,7 +31151,7 @@
{
"name": "list_subscriptions",
"title": "List my copy-trade subscriptions",
- "description": "List the copy-trade subscriptions belonging to the authenticated account — every leader (a trader with a track record) you follow, with their identity, the subscription status (active / paused / stopped), the sizing rule and full guard-rule set, the performance fee, the high-water mark, and live pending/acted copy-intent counts. Use this to audit who you copy and how aggressively before tuning a follow with update_subscription. Returns the subscriptions newest-first. Read-only; requires THREE_WS_API_KEY.",
+ "description": "List the copy-trade subscriptions belonging to the authenticated account - every leader (a trader with a track record) you follow, with their identity, the subscription status (active / paused / stopped), the sizing rule and full guard-rule set, the performance fee, the high-water mark, and live pending/acted copy-intent counts. Use this to audit who you copy and how aggressively before tuning a follow with update_subscription. Returns the subscriptions newest-first. Read-only; requires THREE_WS_API_KEY.",
"whenToUse": "Use this to audit who you copy and how aggressively before tuning a follow with update_subscription.",
"server": {
"id": "copy-mcp",
@@ -31044,7 +31217,7 @@
"copier_wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
- "description": "Your own Solana wallet address that will execute the mirrored trades. Never a private key — non-custodial."
+ "description": "Your own Solana wallet address that will execute the mirrored trades. Never a private key - non-custodial."
},
"network": {
"type": "string",
@@ -31080,7 +31253,7 @@
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
- "description": "Percent of your spendable SOL per copy when sizing_rule=\"pct_balance\" (0–100)."
+ "description": "Percent of your spendable SOL per copy when sizing_rule=\"pct_balance\" (0 - 100)."
},
"per_trade_cap_sol": {
"type": "number",
@@ -31105,7 +31278,7 @@
"minimum": 1,
"maximum": 100,
"default": 5,
- "description": "Cap on concurrent pending copy intents (1–100, default 5)."
+ "description": "Cap on concurrent pending copy intents (1 - 100, default 5)."
},
"mcap_floor_usd": {
"anyOf": [
@@ -31152,14 +31325,14 @@
"type": "null"
}
],
- "description": "Skip coins whose Oracle conviction score is below this (0–100). Omit/null to ignore."
+ "description": "Skip coins whose Oracle conviction score is below this (0 - 100). Omit/null to ignore."
},
"perf_fee_bps": {
"type": "integer",
"minimum": 0,
"maximum": 3000,
"default": 1000,
- "description": "Leader's performance fee on your realized copy profit, in basis points (0–3000, default 1000 = 10%). Charged above a high-water mark, settled in $THREE."
+ "description": "Leader's performance fee on your realized copy profit, in basis points (0 - 3000, default 1000 = 10%). Charged above a high-water mark, settled in $THREE."
},
"telegram_chat_id": {
"anyOf": [
@@ -31254,7 +31427,7 @@
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
- "description": "Percent of your SOL per copy when sizing_rule=\"pct_balance\" (0–100)."
+ "description": "Percent of your SOL per copy when sizing_rule=\"pct_balance\" (0 - 100)."
},
"per_trade_cap_sol": {
"type": "number",
@@ -31275,7 +31448,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Cap on concurrent pending copy intents (1–100)."
+ "description": "Cap on concurrent pending copy intents (1 - 100)."
},
"mcap_floor_usd": {
"anyOf": [
@@ -31320,13 +31493,13 @@
"type": "null"
}
],
- "description": "Skip coins below this Oracle conviction score (0–100). Pass null to clear the gate."
+ "description": "Skip coins below this Oracle conviction score (0 - 100). Pass null to clear the gate."
},
"perf_fee_bps": {
"type": "integer",
"minimum": 0,
"maximum": 3000,
- "description": "Leader's performance fee in basis points (0–3000)."
+ "description": "Leader's performance fee in basis points (0 - 3000)."
},
"telegram_chat_id": {
"anyOf": [
@@ -31432,14 +31605,14 @@
"all"
],
"default": "pending",
- "description": "Lifecycle filter (default \"pending\" — only intents still actionable)."
+ "description": "Lifecycle filter (default \"pending\" - only intents still actionable)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50,
- "description": "Max rows to return, newest first (1–100, default 50)."
+ "description": "Max rows to return, newest first (1 - 100, default 50)."
}
},
"additionalProperties": false,
@@ -32386,7 +32559,7 @@
{
"name": "ibm_granite_getting_started",
"title": "Getting Started (free)",
- "description": "FREE — start here. Returns an overview of this server: the IBM Granite tools available, their per-call USDC prices, how the x402 pay-per-call flow works, setup requirements, and runnable example calls. No payment required. Call this first to orient before invoking a paid tool.",
+ "description": "FREE - start here. Returns an overview of this server: the IBM Granite tools available, their per-call USDC prices, how the x402 pay-per-call flow works, setup requirements, and runnable example calls. No payment required. Call this first to orient before invoking a paid tool.",
"whenToUse": "Call this first to orient before invoking a paid tool.",
"server": {
"id": "ibm-x402-mcp",
@@ -32432,7 +32605,7 @@
{
"name": "ibm_granite_chat",
"title": "IBM Granite Chat ($0.02)",
- "description": "Chat completion powered by IBM Granite foundation models (default: ibm/granite-3-8b-instruct). Send a conversation as role/content message pairs and receive the assistant reply with token usage. Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze. No IBM Cloud account required — pay $0.02 USDC per call via x402.",
+ "description": "Chat completion powered by IBM Granite foundation models (default: ibm/granite-3-8b-instruct). Send a conversation as role/content message pairs and receive the assistant reply with token usage. Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze. No IBM Cloud account required - pay $0.02 USDC per call via x402.",
"whenToUse": "Use this for open-ended conversation or free-form text generation; for code tasks call ibm_granite_code, and for structured JSON extraction call ibm_granite_analyze.",
"server": {
"id": "ibm-x402-mcp",
@@ -32517,7 +32690,7 @@
{
"name": "ibm_granite_code",
"title": "IBM Granite Code ($0.025)",
- "description": "Code generation, review, refactoring, and explanation via IBM Granite instruct models. Provide a task type and code/prompt; receive the generated or reviewed code with explanation. Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead. No IBM Cloud account required — pay $0.025 USDC per call via x402.",
+ "description": "Code generation, review, refactoring, and explanation via IBM Granite instruct models. Provide a task type and code/prompt; receive the generated or reviewed code with explanation. Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead. No IBM Cloud account required - pay $0.025 USDC per call via x402.",
"whenToUse": "Use this when the input is source code or a request to write code; for general conversation call ibm_granite_chat instead.",
"server": {
"id": "ibm-x402-mcp",
@@ -32583,7 +32756,7 @@
{
"name": "ibm_granite_embed",
"title": "IBM Granite Embed ($0.005)",
- "description": "Generate embedding vectors for one or more texts using IBM Granite (default: ibm/granite-embedding-278m-multilingual). Returns one float array per input, suitable for semantic search, RAG retrieval, and similarity scoring. Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer. Up to 64 texts per call. No IBM Cloud account required — pay $0.005 USDC per call via x402.",
+ "description": "Generate embedding vectors for one or more texts using IBM Granite (default: ibm/granite-embedding-278m-multilingual). Returns one float array per input, suitable for semantic search, RAG retrieval, and similarity scoring. Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer. Up to 64 texts per call. No IBM Cloud account required - pay $0.005 USDC per call via x402.",
"whenToUse": "Use this to index documents or compare texts by meaning; it returns vectors, not prose, so call ibm_granite_chat when you need a written answer.",
"server": {
"id": "ibm-x402-mcp",
@@ -32617,7 +32790,7 @@
},
"minItems": 1,
"maxItems": 64,
- "description": "Texts to embed. 1–64 strings per call, up to 8,000 characters each."
+ "description": "Texts to embed. 1 - 64 strings per call, up to 8,000 characters each."
},
"model": {
"type": "string",
@@ -32636,7 +32809,7 @@
{
"name": "ibm_granite_analyze",
"title": "IBM Granite Analyze ($0.04)",
- "description": "Structured document analysis powered by IBM Granite: extract entities, sentiment, risk signals, a concise summary, and recommended next steps from any text (contracts, reports, emails, code reviews, etc.). Returns a machine-readable JSON analysis. Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives. No IBM Cloud account required — pay $0.04 USDC per call via x402.",
+ "description": "Structured document analysis powered by IBM Granite: extract entities, sentiment, risk signals, a concise summary, and recommended next steps from any text (contracts, reports, emails, code reviews, etc.). Returns a machine-readable JSON analysis. Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives. No IBM Cloud account required - pay $0.04 USDC per call via x402.",
"whenToUse": "Use this when you need machine-readable fields (entities, sentiment, risks) from a document rather than the free-text reply ibm_granite_chat gives.",
"server": {
"id": "ibm-x402-mcp",
@@ -32697,7 +32870,7 @@
{
"name": "ibm_granite_forecast",
"title": "IBM Granite Forecast ($0.05)",
- "description": "Zero-shot time-series forecasting via IBM Granite TTM (Tiny Time Mixer). Provide a numeric series with ISO-8601 timestamps and a cadence, receive the forecast horizon. No training required. Suitable for revenue, traffic, sensor, energy, and financial series. Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary. No IBM Cloud account required — pay $0.05 USDC per call via x402.",
+ "description": "Zero-shot time-series forecasting via IBM Granite TTM (Tiny Time Mixer). Provide a numeric series with ISO-8601 timestamps and a cadence, receive the forecast horizon. No training required. Suitable for revenue, traffic, sensor, energy, and financial series. Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary. No IBM Cloud account required - pay $0.05 USDC per call via x402.",
"whenToUse": "Use this to project a numeric series of at least 64 timestamped points forward; it returns numbers only, so pass the result to ibm_granite_analyze if you need commentary.",
"server": {
"id": "ibm-x402-mcp",
@@ -32966,7 +33139,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "How many ranked traders to return (1–100, default 25)."
+ "description": "How many ranked traders to return (1 - 100, default 25)."
}
},
"additionalProperties": false,
@@ -33012,7 +33185,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "How many recent trades to return (1–100, default 20)."
+ "description": "How many recent trades to return (1 - 100, default 20)."
}
},
"required": [
@@ -33090,7 +33263,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Page size (1–100, default 30)."
+ "description": "Page size (1 - 100, default 30)."
},
"offset": {
"type": "integer",
@@ -33467,7 +33640,7 @@
{
"name": "get_wallet_trades",
"title": "A KOL wallet's trades on a mint",
- "description": "Get one specific KOL trader's recent buys/sells of a given mint. The three.ws trade feed is scanned for that mint across all tracked wallets and narrowed to the wallet you pass, so you see exactly how that trader is positioning in that token — side (buy/sell), SOL size, token amount, per-trade price, USD value, and timestamp, newest first. Use it to inspect a single smart trader's moves before copying. For every tracked wallet's trades on a mint (not just one), use intel-mcp `kol_trades`. Read-only live data.",
+ "description": "Get one specific KOL trader's recent buys/sells of a given mint. The three.ws trade feed is scanned for that mint across all tracked wallets and narrowed to the wallet you pass, so you see exactly how that trader is positioning in that token - side (buy/sell), SOL size, token amount, per-trade price, USD value, and timestamp, newest first. Use it to inspect a single smart trader's moves before copying. For every tracked wallet's trades on a mint (not just one), use intel-mcp `kol_trades`. Read-only live data.",
"whenToUse": "Use it to inspect a single smart trader's moves before copying.",
"server": {
"id": "kol-mcp",
@@ -33506,7 +33679,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Max number of this wallet's trades to return (1–100, default 20)."
+ "description": "Max number of this wallet's trades to return (1 - 100, default 20)."
}
},
"required": [
@@ -33522,7 +33695,7 @@
{
"name": "get_loom_feed",
"title": "Browse the Loom 3D-creation gallery",
- "description": "Browse Loom — the public, world-readable gallery of community-forged 3D creations (a forged GLB plus the prompt that made it and a bit of attribution), returned newest-first. Each creation includes its id, prompt, glbUrl, previewImageUrl, author, tier, backend, createdAt (ms epoch), plus a ready-to-use `viewer_url` (the /forge/embed orbit+AR viewer), `og_image_url`, and a paste-ready `iframe_snippet`. Paginate backwards with `before`: pass the `nextBefore` cursor from the previous page to load older items; a null `nextBefore` means you reached the end. Use this to browse or pick recent community creations; for one known id call get_creation instead. Read-only, no key required.",
+ "description": "Browse Loom - the public, world-readable gallery of community-forged 3D creations (a forged GLB plus the prompt that made it and a bit of attribution), returned newest-first. Each creation includes its id, prompt, glbUrl, previewImageUrl, author, tier, backend, createdAt (ms epoch), plus a ready-to-use `viewer_url` (the /forge/embed orbit+AR viewer), `og_image_url`, and a paste-ready `iframe_snippet`. Paginate backwards with `before`: pass the `nextBefore` cursor from the previous page to load older items; a null `nextBefore` means you reached the end. Use this to browse or pick recent community creations; for one known id call get_creation instead. Read-only, no key required.",
"whenToUse": "Use this to browse or pick recent community creations; for one known id call get_creation instead.",
"server": {
"id": "loom-mcp",
@@ -33551,7 +33724,7 @@
"type": "integer",
"minimum": 1,
"maximum": 120,
- "description": "How many creations to return (1–120, default 60)."
+ "description": "How many creations to return (1 - 120, default 60)."
},
"before": {
"type": "integer",
@@ -33568,7 +33741,7 @@
{
"name": "get_creation",
"title": "Fetch one Loom creation by id",
- "description": "Fetch a single Loom creation by its id. Returns the full record — prompt, glbUrl, previewImageUrl, author, tier, backend, createdAt — together with a `viewer_url` (the /forge/embed orbit+AR viewer for the GLB), an `og_image_url`, and a paste-ready `iframe_snippet` so the model can be previewed inline. Returns a not_found error if no creation has that id. Use this when you already have a creation id (from get_loom_feed or a submit_creation result) and need its full record or embed snippet. Read-only, no key required.",
+ "description": "Fetch a single Loom creation by its id. Returns the full record - prompt, glbUrl, previewImageUrl, author, tier, backend, createdAt - together with a `viewer_url` (the /forge/embed orbit+AR viewer for the GLB), an `og_image_url`, and a paste-ready `iframe_snippet` so the model can be previewed inline. Returns a not_found error if no creation has that id. Use this when you already have a creation id (from get_loom_feed or a submit_creation result) and need its full record or embed snippet. Read-only, no key required.",
"whenToUse": "Use this when you already have a creation id (from get_loom_feed or a submit_creation result) and need its full record or embed snippet.",
"server": {
"id": "loom-mcp",
@@ -33611,7 +33784,7 @@
{
"name": "submit_creation",
"title": "Submit a creation to the Loom gallery",
- "description": "Contribute a forged 3D creation to Loom, the PUBLIC, world-readable community gallery. ⚠️ Anything you submit becomes visible to everyone on the platform, so only post models you intend to share. Requires `prompt` (the text that forged it, ≤1000 chars) and `glbUrl` (an https URL to the GLB, hosted on an allowed domain: three.ws, r2.dev, cloudflarestorage.com, replicate.delivery, githubusercontent.com). Optional: `author` attribution (free text, ≤40 chars — NOT an authenticated identity; defaults to \"anon\"), `previewImageUrl`, `tier`, and `backend`. No key or account is needed; the endpoint is rate-limited to ~20 submissions per hour per IP. Re-submitting the exact same glbUrl returns the existing creation instead of duplicating it. Returns the stored creation with its id and a ready-to-use viewer_url + iframe_snippet. The only coin this platform references is $THREE; never put any other token in a prompt. Use this after the user has asked to share a specific model publicly, and only then.",
+ "description": "Contribute a forged 3D creation to Loom, the PUBLIC, world-readable community gallery. ⚠️ Anything you submit becomes visible to everyone on the platform, so only post models you intend to share. Requires `prompt` (the text that forged it, ≤1000 chars) and `glbUrl` (an https URL to the GLB, hosted on an allowed domain: three.ws, r2.dev, cloudflarestorage.com, replicate.delivery, githubusercontent.com). Optional: `author` attribution (free text, ≤40 chars - NOT an authenticated identity; defaults to \"anon\"), `previewImageUrl`, `tier`, and `backend`. No key or account is needed; the endpoint is rate-limited to ~20 submissions per hour per IP. Re-submitting the exact same glbUrl returns the existing creation instead of duplicating it. Returns the stored creation with its id and a ready-to-use viewer_url + iframe_snippet. The only coin this platform references is $THREE; never put any other token in a prompt. Use this after the user has asked to share a specific model publicly, and only then.",
"whenToUse": "Use this after the user has asked to share a specific model publicly, and only then.",
"server": {
"id": "loom-mcp",
@@ -33640,7 +33813,7 @@
"type": "string",
"minLength": 1,
"maxLength": 1000,
- "description": "The prompt that forged the model. Required, 1–1000 chars. Shown publicly under the creation."
+ "description": "The prompt that forged the model. Required, 1 - 1000 chars. Shown publicly under the creation."
},
"glbUrl": {
"type": "string",
@@ -33726,7 +33899,7 @@
"type": "integer",
"minimum": 1,
"maximum": 48,
- "description": "How many agents to return (1–48, default 24)."
+ "description": "How many agents to return (1 - 48, default 24)."
},
"cursor": {
"type": "string",
@@ -33859,13 +34032,13 @@
"az"
],
"default": "popular",
- "description": "Sort order: \"popular\" (default, by install count), \"new\" (most recent), or \"az\" (A–Z)."
+ "description": "Sort order: \"popular\" (default, by install count), \"new\" (most recent), or \"az\" (A - Z)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
- "description": "How many skills to return (1–50, default 20)."
+ "description": "How many skills to return (1 - 50, default 20)."
},
"cursor": {
"type": "string",
@@ -35576,7 +35749,7 @@
"label": {
"type": "string",
"minLength": 1,
- "description": "The label to check, e.g. \"nick\" for \"nick.threews.sol\" (1–63 chars of [a-z0-9-])."
+ "description": "The label to check, e.g. \"nick\" for \"nick.threews.sol\" (1 - 63 chars of [a-z0-9-])."
}
},
"required": [
@@ -35591,7 +35764,7 @@
{
"name": "list_notifications",
"title": "List notifications",
- "description": "Read the authenticated agent's notification inbox — the inbound-event feed the platform delivers to the account: market/pump alerts, sales & earnings, purchase receipts, social mentions, IRL interactions, and account/security notices. Returns the most recent notifications (newest first), each with its `id`, `type`, the event `payload`, a `read` boolean and `read_at` timestamp (null ⇒ unread), and `created_at`; plus `unread_count`, the total number of unread items in the inbox. Pass `type` to return only one notification type (e.g. \"pump_alert\", \"skill_purchased\", \"security_alert\"), and `limit` (1-50, default 20) to cap how many rows come back. Read-only. Use it to surface alerts without polling, then mark_read / delete_notification to manage them.",
+ "description": "Read the authenticated agent's notification inbox - the inbound-event feed the platform delivers to the account: market/pump alerts, sales & earnings, purchase receipts, social mentions, IRL interactions, and account/security notices. Returns the most recent notifications (newest first), each with its `id`, `type`, the event `payload`, a `read` boolean and `read_at` timestamp (null ⇒ unread), and `created_at`; plus `unread_count`, the total number of unread items in the inbox. Pass `type` to return only one notification type (e.g. \"pump_alert\", \"skill_purchased\", \"security_alert\"), and `limit` (1-50, default 20) to cap how many rows come back. Read-only. Use it to surface alerts without polling, then mark_read / delete_notification to manage them.",
"whenToUse": "Use it to surface alerts without polling, then mark_read / delete_notification to manage them.",
"server": {
"id": "notifications-mcp",
@@ -35625,7 +35798,7 @@
"type": "integer",
"minimum": 1,
"maximum": 50,
- "description": "How many notifications to return, newest first. 1–50, default 20."
+ "description": "How many notifications to return, newest first. 1 - 50, default 20."
}
},
"additionalProperties": false,
@@ -35637,7 +35810,7 @@
{
"name": "mark_read",
"title": "Mark notifications read",
- "description": "Mark notifications as read in the inbox. Pass `id` to mark a single notification read, or `all: true` to mark every unread notification read at once (exactly one of the two is required). Marking read only updates the read timestamp — it does not delete anything, and re-running with the same arguments has no further effect (idempotent). When `id` is given, returns the notification id and its `read_at`; when `all` is given, returns `marked_read`, the number of notifications newly marked read. Use this for normal triage after list_notifications; to remove a notification entirely use delete_notification instead.",
+ "description": "Mark notifications as read in the inbox. Pass `id` to mark a single notification read, or `all: true` to mark every unread notification read at once (exactly one of the two is required). Marking read only updates the read timestamp - it does not delete anything, and re-running with the same arguments has no further effect (idempotent). When `id` is given, returns the notification id and its `read_at`; when `all` is given, returns `marked_read`, the number of notifications newly marked read. Use this for normal triage after list_notifications; to remove a notification entirely use delete_notification instead.",
"whenToUse": "Use this for normal triage after list_notifications; to remove a notification entirely use delete_notification instead.",
"server": {
"id": "notifications-mcp",
@@ -35681,7 +35854,7 @@
{
"name": "delete_notification",
"title": "Delete notification",
- "description": "Permanently delete a single notification from the inbox by its `id` (from list_notifications). Unlike mark_read, which only marks it read, this REMOVES the notification for good — the action is irreversible. Only a notification the caller owns can be deleted. Returns `{ ok: true, id, deleted: true }` on success, or a not_found error if the id does not exist for this account (e.g. it was already deleted). Use this to discard a notification entirely; prefer mark_read for normal triage.",
+ "description": "Permanently delete a single notification from the inbox by its `id` (from list_notifications). Unlike mark_read, which only marks it read, this REMOVES the notification for good - the action is irreversible. Only a notification the caller owns can be deleted. Returns `{ ok: true, id, deleted: true }` on success, or a not_found error if the id does not exist for this account (e.g. it was already deleted). Use this to discard a notification entirely; prefer mark_read for normal triage.",
"whenToUse": "Use this to discard a notification entirely; prefer mark_read for normal triage.",
"server": {
"id": "notifications-mcp",
@@ -35724,7 +35897,7 @@
{
"name": "get_preferences",
"title": "Get notification preferences",
- "description": "Read the account's notification delivery preferences — the resolved channel matrix the platform uses to decide how each kind of event reaches the owner. Returns `categories` (the catalog of user-facing groups: sales, purchases, social, irl, alerts, creations, account, each with a label, a description, and any `lockedChannels` that cannot be switched off), `channels` (the deliverable channels: in_app, push, email, telegram), `prefs` (the effective per-category → per-channel on/off matrix with sparse user overrides already merged onto defaults, plus the linked `telegram_chat_id` if any), and `push` (how many web-push devices are registered). Call this before set_preferences so you patch from the real current state. Read-only.",
+ "description": "Read the account's notification delivery preferences - the resolved channel matrix the platform uses to decide how each kind of event reaches the owner. Returns `categories` (the catalog of user-facing groups: sales, purchases, social, irl, alerts, creations, account, each with a label, a description, and any `lockedChannels` that cannot be switched off), `channels` (the deliverable channels: in_app, push, email, telegram), `prefs` (the effective per-category → per-channel on/off matrix with sparse user overrides already merged onto defaults, plus the linked `telegram_chat_id` if any), and `push` (how many web-push devices are registered). Call this before set_preferences so you patch from the real current state. Read-only.",
"whenToUse": "Call this before set_preferences so you patch from the real current state.",
"server": {
"id": "notifications-mcp",
@@ -35757,7 +35930,7 @@
{
"name": "set_preferences",
"title": "Set notification preferences",
- "description": "Update the account's notification delivery preferences with a sparse patch. `categories` maps a category key (sales, purchases, social, irl, alerts, creations, account) to a channel map turning each channel on/off (in_app, push, email, telegram) — e.g. { \"alerts\": { \"push\": false }, \"social\": { \"email\": true } }. Only the category/channel pairs you pass change; unknown keys are dropped server-side and untouched pairs keep their current value (which falls back to the platform default). Pass `telegram_chat_id` (a numeric Telegram chat id, or \"\" to unlink) to control where the telegram channel delivers. Provide at least one of `categories` or `telegram_chat_id`. `account` locks its `in_app` channel on: security and withdrawal notices always reach the bell inbox, so `false` there is ignored. WRITE but idempotent, re-applying the same values is a no-op. Returns the full resolved preference matrix after the update. Use this when the owner wants a category on or off for a channel, after reading the current matrix with get_preferences.",
+ "description": "Update the account's notification delivery preferences with a sparse patch. `categories` maps a category key (sales, purchases, social, irl, alerts, creations, account) to a channel map turning each channel on/off (in_app, push, email, telegram) - e.g. { \"alerts\": { \"push\": false }, \"social\": { \"email\": true } }. Only the category/channel pairs you pass change; unknown keys are dropped server-side and untouched pairs keep their current value (which falls back to the platform default). Pass `telegram_chat_id` (a numeric Telegram chat id, or \"\" to unlink) to control where the telegram channel delivers. Provide at least one of `categories` or `telegram_chat_id`. `account` locks its `in_app` channel on: security and withdrawal notices always reach the bell inbox, so `false` there is ignored. WRITE but idempotent, re-applying the same values is a no-op. Returns the full resolved preference matrix after the update. Use this when the owner wants a category on or off for a channel, after reading the current matrix with get_preferences.",
"whenToUse": "Use this when the owner wants a category on or off for a channel, after reading the current matrix with get_preferences.",
"server": {
"id": "notifications-mcp",
@@ -35807,7 +35980,7 @@
{
"name": "register_push_device",
"title": "Register push device",
- "description": "Register a Web Push device so the account receives push notifications on it. Pass the browser `subscription` object exactly as `pushManager.subscribe().toJSON()` produces it — { endpoint, keys: { p256dh, auth } }. Push endpoints are globally unique: re-registering the same device upserts (the latest owner wins) and is a no-op, so this is idempotent. Whether a given notification category actually delivers over push is still governed by set_preferences. Returns `{ ok: true }` on success. Use this when a browser has just granted push permission; use unregister_push_device to remove a device.",
+ "description": "Register a Web Push device so the account receives push notifications on it. Pass the browser `subscription` object exactly as `pushManager.subscribe().toJSON()` produces it - { endpoint, keys: { p256dh, auth } }. Push endpoints are globally unique: re-registering the same device upserts (the latest owner wins) and is a no-op, so this is idempotent. Whether a given notification category actually delivers over push is still governed by set_preferences. Returns `{ ok: true }` on success. Use this when a browser has just granted push permission; use unregister_push_device to remove a device.",
"whenToUse": "Use this when a browser has just granted push permission; use unregister_push_device to remove a device.",
"server": {
"id": "notifications-mcp",
@@ -35885,7 +36058,7 @@
{
"name": "unregister_push_device",
"title": "Unregister push device",
- "description": "Remove a Web Push device so the account stops receiving push notifications on it. Identify the device by its push `endpoint` URL (preferred) or by passing the full `subscription` object — at least one is required. Destructive: it tears down the device registration (reverse it by calling register_push_device again). Idempotent: removing an endpoint that is not registered still returns `{ ok: true }`. This affects only push delivery to that device; in_app, email, and telegram preferences are unchanged. Use this when a browser or device should stop getting push; to silence a whole category everywhere use set_preferences instead.",
+ "description": "Remove a Web Push device so the account stops receiving push notifications on it. Identify the device by its push `endpoint` URL (preferred) or by passing the full `subscription` object - at least one is required. Destructive: it tears down the device registration (reverse it by calling register_push_device again). Idempotent: removing an endpoint that is not registered still returns `{ ok: true }`. This affects only push delivery to that device; in_app, email, and telegram preferences are unchanged. Use this when a browser or device should stop getting push; to silence a whole category everywhere use set_preferences instead.",
"whenToUse": "Use this when a browser or device should stop getting push; to silence a whole category everywhere use set_preferences instead.",
"server": {
"id": "notifications-mcp",
@@ -35961,8 +36134,8 @@
},
{
"name": "get_portfolio_summary",
- "title": "My agents’ live portfolio (holdings + USD value)",
- "description": "Live aggregated portfolio for the agent wallets YOU own (resolved from your three.ws session). Returns `total_usd` across all wallets and a per-wallet breakdown — each with agent_id, agent_name, chain (solana | evm), address, the resolved .sol name when present, the native balance (SOL/ETH amount + USD), the SPL/ERC-20 token holdings (amount + USD), and that wallet’s USD subtotal. A wallet that failed to price carries `ok:false` and an `error` instead of throwing the whole call. Note: this is the live VALUE snapshot — realized PnL lives in get_trades_feed. Set `snapshot:true` to persist a point for the history chart. Use this first for \"what do my agents hold\"; drill into one token with get_portfolio_asset. Requires THREE_WS_SESSION. Read-only unless `snapshot:true`, which writes one history point.",
+ "title": "My agents' live portfolio (holdings + USD value)",
+ "description": "Live aggregated portfolio for the agent wallets YOU own (resolved from your three.ws session). Returns `total_usd` across all wallets and a per-wallet breakdown - each with agent_id, agent_name, chain (solana | evm), address, the resolved .sol name when present, the native balance (SOL/ETH amount + USD), the SPL/ERC-20 token holdings (amount + USD), and that wallet's USD subtotal. A wallet that failed to price carries `ok:false` and an `error` instead of throwing the whole call. Note: this is the live VALUE snapshot - realized PnL lives in get_trades_feed. Set `snapshot:true` to persist a point for the history chart. Use this first for \"what do my agents hold\"; drill into one token with get_portfolio_asset. Requires THREE_WS_SESSION. Read-only unless `snapshot:true`, which writes one history point.",
"whenToUse": "Use this first for \"what do my agents hold\"; drill into one token with get_portfolio_asset.",
"server": {
"id": "portfolio-mcp",
@@ -36002,7 +36175,7 @@
{
"name": "get_portfolio_history",
"title": "My portfolio value over time",
- "description": "Time series of your total portfolio USD value, oldest point first, for charting performance over time. Returns `points` as { t (ISO timestamp), usd } pairs, drawn from snapshots persisted by get_portfolio_summary(snapshot:true) or the website. An empty `points` array means no snapshots have been captured yet in the window — take one with get_portfolio_summary(snapshot:true) to start the series. Use this to chart or describe performance over time; for the current value call get_portfolio_summary. Requires THREE_WS_SESSION. Read-only.",
+ "description": "Time series of your total portfolio USD value, oldest point first, for charting performance over time. Returns `points` as { t (ISO timestamp), usd } pairs, drawn from snapshots persisted by get_portfolio_summary(snapshot:true) or the website. An empty `points` array means no snapshots have been captured yet in the window - take one with get_portfolio_summary(snapshot:true) to start the series. Use this to chart or describe performance over time; for the current value call get_portfolio_summary. Requires THREE_WS_SESSION. Read-only.",
"whenToUse": "Use this to chart or describe performance over time; for the current value call get_portfolio_summary.",
"server": {
"id": "portfolio-mcp",
@@ -36032,7 +36205,7 @@
"minimum": 1,
"maximum": 365,
"default": 90,
- "description": "How many days of history to return, 1–365 (default 90)."
+ "description": "How many days of history to return, 1 - 365 (default 90)."
}
},
"additionalProperties": false,
@@ -36044,7 +36217,7 @@
{
"name": "get_portfolio_asset",
"title": "My position in one token (holdings + market + chart)",
- "description": "Deep-dive on ONE asset across every agent wallet you own. Returns which wallets hold it, your `total_amount` and `total_usd`, the per-wallet `holdings`, the live `market` data (price, 24h/7d/30d change, market cap, volume, ATH) and a `chart` of price history over `days`. Use `id:\"native\"` for the chain’s base coin (SOL on solana, ETH on evm), otherwise the base58 SPL mint or the 0x contract address. Use this to answer questions about one token you hold; for the whole portfolio call get_portfolio_summary. Requires THREE_WS_SESSION. Read-only.",
+ "description": "Deep-dive on ONE asset across every agent wallet you own. Returns which wallets hold it, your `total_amount` and `total_usd`, the per-wallet `holdings`, the live `market` data (price, 24h/7d/30d change, market cap, volume, ATH) and a `chart` of price history over `days`. Use `id:\"native\"` for the chain's base coin (SOL on solana, ETH on evm), otherwise the base58 SPL mint or the 0x contract address. Use this to answer questions about one token you hold; for the whole portfolio call get_portfolio_summary. Requires THREE_WS_SESSION. Read-only.",
"whenToUse": "Use this to answer questions about one token you hold; for the whole portfolio call get_portfolio_summary.",
"server": {
"id": "portfolio-mcp",
@@ -36087,7 +36260,7 @@
"minimum": 1,
"maximum": 365,
"default": 30,
- "description": "Days of price history for the chart, 1–365 (default 30)."
+ "description": "Days of price history for the chart, 1 - 365 (default 30)."
},
"chain_id": {
"type": "integer",
@@ -36108,7 +36281,7 @@
{
"name": "get_trades_feed",
"title": "Public closed-trade PnL feed",
- "description": "The public feed of notable CLOSED positions across all three.ws agents, newest exit first — the canonical source of realized PnL on the platform. Each item carries the coin (mint, symbol, name), the trader (agent_id, agent_name, copier_count), entry_sol / exit_sol / realized_pnl_sol / realized_pnl_pct / multiple, where realized_pnl_pct and multiple are the whole position's return across every sell leg while entry_sol and exit_sol describe the remaining cost basis and the closing leg only, hold_seconds, exit_reason, the buy/sell signatures, and oracle conviction context when the coin was scored. Filter by `mint` to see every closed trade on one coin (the time window is ignored when a mint is set). Paginate with `cursor` = the previous response's `next_cursor`. No auth required; read-only live data. Use this for realized PnL and closed-trade history; for current holdings call get_portfolio_summary.",
+ "description": "The public feed of notable CLOSED positions across all three.ws agents, newest exit first - the canonical source of realized PnL on the platform. Each item carries the coin (mint, symbol, name), the trader (agent_id, agent_name, copier_count), entry_sol / exit_sol / realized_pnl_sol / realized_pnl_pct / multiple, where realized_pnl_pct and multiple are the whole position's return across every sell leg while entry_sol and exit_sol describe the remaining cost basis and the closing leg only, hold_seconds, exit_reason, the buy/sell signatures, and oracle conviction context when the coin was scored. Filter by `mint` to see every closed trade on one coin (the time window is ignored when a mint is set). Paginate with `cursor` = the previous response's `next_cursor`. No auth required; read-only live data. Use this for realized PnL and closed-trade history; for current holdings call get_portfolio_summary.",
"whenToUse": "Use this for realized PnL and closed-trade history; for current holdings call get_portfolio_summary.",
"server": {
"id": "portfolio-mcp",
@@ -36166,11 +36339,11 @@
"minimum": 1,
"maximum": 80,
"default": 40,
- "description": "Max items to return, 1–80 (default 40)."
+ "description": "Max items to return, 1 - 80 (default 40)."
},
"cursor": {
"type": "string",
- "description": "ISO timestamp for pagination — pass the previous response's `next_cursor`."
+ "description": "ISO timestamp for pagination - pass the previous response's `next_cursor`."
},
"mint": {
"type": "string",
@@ -36186,8 +36359,8 @@
{
"name": "get_wallet_balances",
"title": "Live on-chain balances for a Solana wallet",
- "description": "Read live, on-chain balances for any Solana pubkey directly from the RPC: the native SOL balance plus every non-zero SPL token position (classic SPL and Token-2022), each with mint, raw amount, ui_amount, decimals, and which token program owns it. This is the raw on-chain truth (no USD pricing). Use it to confirm the agent’s own signing wallet before a send_transfer, or to check any address. No session required. Read-only.",
- "whenToUse": "Use it to confirm the agent’s own signing wallet before a send_transfer, or to check any address.",
+ "description": "Read live, on-chain balances for any Solana pubkey directly from the RPC: the native SOL balance plus every non-zero SPL token position (classic SPL and Token-2022), each with mint, raw amount, ui_amount, decimals, and which token program owns it. This is the raw on-chain truth (no USD pricing). Use it to confirm the agent's own signing wallet before a send_transfer, or to check any address. No session required. Read-only.",
+ "whenToUse": "Use it to confirm the agent's own signing wallet before a send_transfer, or to check any address.",
"server": {
"id": "portfolio-mcp",
"title": "@three-ws/portfolio-mcp",
@@ -36299,7 +36472,7 @@
{
"name": "send_transfer",
"title": "Send SOL or an SPL token on Solana mainnet",
- "description": "BROADCASTS A REAL, IRREVERSIBLE SOLANA MAINNET TRANSACTION that moves funds out of the agent’s own wallet. Sends native SOL (omit `mint`, or set mint:\"native\") or any SPL token (pass its base58 `mint` — supplied at call time, e.g. the $THREE mint or any token you hold). Signs locally with the per-call `secret` (base58) or SOLANA_SECRET_KEY on the server; for a token it auto-creates the recipient’s associated token account when missing. Returns the confirmed signature, the moved amount, and a Solscan link. EXECUTION ACTION — pass confirm:true to proceed. Native sends are capped by MAX_SOL_PER_TX; the recipient must be in RECIPIENT_ALLOWLIST when one is configured. Use this after preview_transfer, and only on the person's explicit yes to that recipient and amount.",
+ "description": "BROADCASTS A REAL, IRREVERSIBLE SOLANA MAINNET TRANSACTION that moves funds out of the agent's own wallet. Sends native SOL (omit `mint`, or set mint:\"native\") or any SPL token (pass its base58 `mint` - supplied at call time, e.g. the $THREE mint or any token you hold). Signs locally with the per-call `secret` (base58) or SOLANA_SECRET_KEY on the server; for a token it auto-creates the recipient's associated token account when missing. Returns the confirmed signature, the moved amount, and a Solscan link. EXECUTION ACTION - pass confirm:true to proceed. Native sends are capped by MAX_SOL_PER_TX; the recipient must be in RECIPIENT_ALLOWLIST when one is configured. Use this after preview_transfer, and only on the person's explicit yes to that recipient and amount.",
"whenToUse": "Use this after preview_transfer, and only on the person's explicit yes to that recipient and amount.",
"server": {
"id": "portfolio-mcp",
@@ -36337,7 +36510,7 @@
},
"mint": {
"type": "string",
- "description": "SPL token mint (base58) to send. Omit or set \"native\" to send SOL. Runtime input — any mint you hold."
+ "description": "SPL token mint (base58) to send. Omit or set \"native\" to send SOL. Runtime input - any mint you hold."
},
"secret": {
"type": "string",
@@ -36402,12 +36575,12 @@
"minimum": 1,
"maximum": 200,
"default": 50,
- "description": "Max actions to return (1–200, default 50)."
+ "description": "Max actions to return (1 - 200, default 50)."
},
"cursor": {
"type": "string",
"pattern": "^\\d+$",
- "description": "Pagination cursor — pass the `next_cursor` from a previous call to fetch the next (older) page."
+ "description": "Pagination cursor - pass the `next_cursor` from a previous call to fetch the next (older) page."
}
},
"required": [
@@ -36510,7 +36683,7 @@
"payload": {
"type": "object",
"additionalProperties": {},
- "description": "Structured details of the action (any JSON object) — e.g. { mint, amount_sol, signature }. Stored verbatim and covered by the signature."
+ "description": "Structured details of the action (any JSON object) - e.g. { mint, amount_sol, signature }. Stored verbatim and covered by the signature."
},
"source_skill": {
"type": "string",
@@ -37814,7 +37987,7 @@
{
"name": "list_signal_feeds",
"title": "Browse the signal-feed marketplace",
- "description": "Discover copy-trade signal feeds on three.ws. Returns the public directory of active feeds, each ranked by its PROVEN realized edge (hit-rate × realized ROI, confidence-regressed toward the publisher's verified track-record score until enough signals have closed — a thin feed riding one lucky call can never top a deep, consistent one). For each feed you get its numeric `id` (pass this to subscribe_signal), `slug`, title, the publisher (name, verified badge, track-record score, realized SOL P&L), pricing (per-signal and per-epoch USDC), and proven stats (closed signals, hit-rate, average realized %, active subscribers, executed fills, avg emit→fill latency, avg follower ROI). Sort by `edge` (default), `roi`, `hitrate`, `subscribers`, or `newest`. Public, read-only live data; no key required. Use this to choose a feed before subscribe_signal; to rank the publishers themselves call get_mirror_leaderboard.",
+ "description": "Discover copy-trade signal feeds on three.ws. Returns the public directory of active feeds, each ranked by its PROVEN realized edge (hit-rate × realized ROI, confidence-regressed toward the publisher's verified track-record score until enough signals have closed - a thin feed riding one lucky call can never top a deep, consistent one). For each feed you get its numeric `id` (pass this to subscribe_signal), `slug`, title, the publisher (name, verified badge, track-record score, realized SOL P&L), pricing (per-signal and per-epoch USDC), and proven stats (closed signals, hit-rate, average realized %, active subscribers, executed fills, avg emit→fill latency, avg follower ROI). Sort by `edge` (default), `roi`, `hitrate`, `subscribers`, or `newest`. Public, read-only live data; no key required. Use this to choose a feed before subscribe_signal; to rank the publishers themselves call get_mirror_leaderboard.",
"whenToUse": "Use this to choose a feed before subscribe_signal; to rank the publishers themselves call get_mirror_leaderboard.",
"server": {
"id": "signals-mcp",
@@ -37865,7 +38038,7 @@
"minimum": 1,
"maximum": 100,
"default": 60,
- "description": "Maximum feeds to return (1–100, default 60)."
+ "description": "Maximum feeds to return (1 - 100, default 60)."
}
},
"additionalProperties": false,
@@ -37877,7 +38050,7 @@
{
"name": "get_mirror_leaderboard",
"title": "Rank signal publishers by realized performance",
- "description": "Rank followable agents (signal publishers / copy-trade leaders) by REAL, on-chain-derived performance — never inflated. Every number traces to a real signature: realized P&L and win-rate come from closed sniper round-trips, volume from the discretionary custody ledger, and losers are included. Each leader returns rank, agent_id, name, avatar, settled trades, wins, win_rate, realized pnl_sol, roi_pct, trade count, volume_sol, follower counts, last trade time, and a composite score (realized ROI weighted by sample size so a one-trade fluke cannot top a consistent trader). Sort by `score` (default), `pnl`, `followers`, `volume`, or `winrate`. Use this to find a leader before subscribing to their feed. Public, read-only live data — no key required.",
+ "description": "Rank followable agents (signal publishers / copy-trade leaders) by REAL, on-chain-derived performance - never inflated. Every number traces to a real signature: realized P&L and win-rate come from closed sniper round-trips, volume from the discretionary custody ledger, and losers are included. Each leader returns rank, agent_id, name, avatar, settled trades, wins, win_rate, realized pnl_sol, roi_pct, trade count, volume_sol, follower counts, last trade time, and a composite score (realized ROI weighted by sample size so a one-trade fluke cannot top a consistent trader). Sort by `score` (default), `pnl`, `followers`, `volume`, or `winrate`. Use this to find a leader before subscribing to their feed. Public, read-only live data - no key required.",
"whenToUse": "Use this to find a leader before subscribing to their feed.",
"server": {
"id": "signals-mcp",
@@ -37928,7 +38101,7 @@
"minimum": 1,
"maximum": 50,
"default": 25,
- "description": "Maximum leaders to return (1–50, default 25)."
+ "description": "Maximum leaders to return (1 - 50, default 25)."
}
},
"additionalProperties": false,
@@ -37940,7 +38113,7 @@
{
"name": "get_subscriptions",
"title": "List your signal subscriptions + delivery history",
- "description": "List every signal subscription owned by the authenticated account — the follower's tracking surface. Each subscription returns its numeric `id` (pass this to set_subscription_status), the subscriber agent, the feed it follows (slug, title, publisher, pricing), the copy-trade config (mode simulate/live, billing, base_sol, size_scaling, max_per_trade_sol, slippage_bps, firewall_level, copy_exits), live status (status, killed flag, epoch_paid_until, last delivered emission), and the realized delivery stats: `stats.executed` (mirror fills that executed on-chain), `stats.paid_count` (paid deliveries), and `stats.usdc_spent` (total USDC paid to the publisher). Use this to check what you follow and what it has cost before changing a subscription with set_subscription_status. Requires THREE_WS_API_KEY. Read-only live data.",
+ "description": "List every signal subscription owned by the authenticated account - the follower's tracking surface. Each subscription returns its numeric `id` (pass this to set_subscription_status), the subscriber agent, the feed it follows (slug, title, publisher, pricing), the copy-trade config (mode simulate/live, billing, base_sol, size_scaling, max_per_trade_sol, slippage_bps, firewall_level, copy_exits), live status (status, killed flag, epoch_paid_until, last delivered emission), and the realized delivery stats: `stats.executed` (mirror fills that executed on-chain), `stats.paid_count` (paid deliveries), and `stats.usdc_spent` (total USDC paid to the publisher). Use this to check what you follow and what it has cost before changing a subscription with set_subscription_status. Requires THREE_WS_API_KEY. Read-only live data.",
"whenToUse": "Use this to check what you follow and what it has cost before changing a subscription with set_subscription_status.",
"server": {
"id": "signals-mcp",
@@ -37973,7 +38146,7 @@
{
"name": "subscribe_signal",
"title": "Subscribe an agent to a signal feed",
- "description": "Subscribe one of YOUR agents to a signal feed so it copy-trades the publisher. Idempotent: a feed is keyed by (subscriber agent, feed) — re-calling updates the existing subscription instead of creating a duplicate. A new subscription starts at the current emission head, so it is never charged for or made to mirror signals emitted before it subscribed.\n\nPAYMENT & RISK: `mode:\"simulate\"` (default) mirrors WITHOUT paying or trading — it sizes and labels the orders for trust-building, spends nothing. `mode:\"live\"` BOTH pays the publisher in USDC (x402, per-signal or per-epoch per the feed pricing) AND auto-mirrors real on-chain trades from the subscriber agent's custodial wallet, within its spend policy. Money moves at delivery time (when the publisher emits a signal), not at the moment you call this tool. Use set_subscription_status with killed:true to halt all further pay/trade instantly. Requires THREE_WS_API_KEY; the agent must be owned by that account. Use this after picking a feed with list_signal_feeds; start in simulate mode and switch to live only on the owner's explicit say-so.",
+ "description": "Subscribe one of YOUR agents to a signal feed so it copy-trades the publisher. Idempotent: a feed is keyed by (subscriber agent, feed) - re-calling updates the existing subscription instead of creating a duplicate. A new subscription starts at the current emission head, so it is never charged for or made to mirror signals emitted before it subscribed.\n\nPAYMENT & RISK: `mode:\"simulate\"` (default) mirrors WITHOUT paying or trading - it sizes and labels the orders for trust-building, spends nothing. `mode:\"live\"` BOTH pays the publisher in USDC (x402, per-signal or per-epoch per the feed pricing) AND auto-mirrors real on-chain trades from the subscriber agent's custodial wallet, within its spend policy. Money moves at delivery time (when the publisher emits a signal), not at the moment you call this tool. Use set_subscription_status with killed:true to halt all further pay/trade instantly. Requires THREE_WS_API_KEY; the agent must be owned by that account. Use this after picking a feed with list_signal_feeds; start in simulate mode and switch to live only on the owner's explicit say-so.",
"whenToUse": "Use this after picking a feed with list_signal_feeds; start in simulate mode and switch to live only on the owner's explicit say-so.",
"server": {
"id": "signals-mcp",
@@ -38006,7 +38179,7 @@
"feed_id": {
"type": "integer",
"exclusiveMinimum": 0,
- "description": "Numeric feed id to follow (from list_signal_feeds — the `id` field). The feed must be active."
+ "description": "Numeric feed id to follow (from list_signal_feeds - the `id` field). The feed must be active."
},
"mode": {
"type": "string",
@@ -38030,25 +38203,25 @@
"type": "number",
"minimum": 0.001,
"maximum": 10,
- "description": "Base order size in SOL before the per-signal size multiple/scaling (0.001–10, default 0.05)."
+ "description": "Base order size in SOL before the per-signal size multiple/scaling (0.001 - 10, default 0.05)."
},
"size_scaling": {
"type": "number",
"minimum": 0.01,
"maximum": 20,
- "description": "Multiplier applied on top of the base size (0.01–20, default 1)."
+ "description": "Multiplier applied on top of the base size (0.01 - 20, default 1)."
},
"max_per_trade_sol": {
"type": "number",
"minimum": 0.001,
"maximum": 50,
- "description": "Hard cap on any single mirrored order in SOL (0.001–50, default 0.25)."
+ "description": "Hard cap on any single mirrored order in SOL (0.001 - 50, default 0.25)."
},
"slippage_bps": {
"type": "integer",
"minimum": 0,
"maximum": 5000,
- "description": "Max slippage in basis points for mirrored trades (0–5000, default 300 = 3%)."
+ "description": "Max slippage in basis points for mirrored trades (0 - 5000, default 300 = 3%)."
},
"firewall_level": {
"type": "string",
@@ -38078,7 +38251,7 @@
{
"name": "set_subscription_status",
"title": "Resume, pause, stop, or kill a subscription",
- "description": "Control an existing signal subscription owned by the authenticated account.\n • active — (re)activate it; this also CLEARS any kill flag so it resumes paying/mirroring.\n • paused — stop delivering for now; the kill flag (if set) is left untouched.\n • stopped — stop the subscription (soft — its delivery history is kept).\n • killed — INSTANT kill switch: halts everything immediately; the kill is honoured before any payment or trade can fire. Use this to stop a live subscription from spending or trading right now.\nIdempotent — setting the same state again is a no-op. Get the subscription `id` from get_subscriptions. Requires THREE_WS_API_KEY.",
+ "description": "Control an existing signal subscription owned by the authenticated account.\n • active - (re)activate it; this also CLEARS any kill flag so it resumes paying/mirroring.\n • paused - stop delivering for now; the kill flag (if set) is left untouched.\n • stopped - stop the subscription (soft - its delivery history is kept).\n • killed - INSTANT kill switch: halts everything immediately; the kill is honoured before any payment or trade can fire. Use this to stop a live subscription from spending or trading right now.\nIdempotent - setting the same state again is a no-op. Get the subscription `id` from get_subscriptions. Requires THREE_WS_API_KEY.",
"whenToUse": "Use this to stop a live subscription from spending or trading right now.",
"server": {
"id": "signals-mcp",
@@ -38780,7 +38953,7 @@
{
"name": "vanity_quote",
"title": "Quote the bounty price for a vanity pattern",
- "description": "Quote how hard a Solana vanity address is and what to escrow for it. Give a Base58 prefix and/or suffix and get the expected attempts, rarity tier, and an honest suggested USDC bounty (atomic units) from the difficulty→price oracle. Pure function of the pattern — no wallet, no payment, fully read-only. Use this before posting a grind-bounty so you escrow a fair amount.",
+ "description": "Quote how hard a Solana vanity address is and what to escrow for it. Give a Base58 prefix and/or suffix and get the expected attempts, rarity tier, and an honest suggested USDC bounty (atomic units) from the difficulty→price oracle. Pure function of the pattern - no wallet, no payment, fully read-only. Use this before posting a grind-bounty so you escrow a fair amount.",
"whenToUse": "Use this before posting a grind-bounty so you escrow a fair amount.",
"server": {
"id": "vanity-mcp",
@@ -38856,7 +39029,7 @@
"type": "string",
"minLength": 32,
"maxLength": 44,
- "description": "The Base58 Solana public key to appraise (32–44 chars)."
+ "description": "The Base58 Solana public key to appraise (32 - 44 chars)."
},
"prefixLen": {
"type": "integer",
@@ -38930,7 +39103,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Max bounties to return (1–100, default 24)."
+ "description": "Max bounties to return (1 - 100, default 24)."
},
"offset": {
"type": "integer",
@@ -38976,7 +39149,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Max claimable bounties to return (1–100, default 30)."
+ "description": "Max claimable bounties to return (1 - 100, default 30)."
}
},
"additionalProperties": false,
@@ -39051,7 +39224,7 @@
"minimum": 1,
"maximum": 100,
"default": 10,
- "description": "How many top grinders to return (1–100, default 10)."
+ "description": "How many top grinders to return (1 - 100, default 10)."
}
},
"additionalProperties": false,
@@ -39147,7 +39320,7 @@
"type": "integer",
"minimum": 1,
"maximum": 100,
- "description": "Max entries to return (1–100, default 24)."
+ "description": "Max entries to return (1 - 100, default 24)."
},
"offset": {
"type": "integer",
@@ -39164,7 +39337,7 @@
{
"name": "analyze_image",
"title": "Analyze an image against a prompt",
- "description": "Let the agent SEE an image and answer a question about it. Supply the image as `imageUrl` (a public https URL the vision server fetches) OR `image` (raw base64 / a data: URI), and a `prompt` describing what to extract — e.g. \"What objects are in this scene?\", \"Read the text in this screenshot\", \"Is this avatar render rigged correctly?\". Returns the model's answer as `text`, plus the `provider` and `model` that served it (a free NVIDIA NIM lane when available, an automatic paid backstop otherwise — the caller never pays). Analysis only: it does not store or mutate anything. Accepts JPEG, PNG, WebP, or GIF up to 12 MB; base64 inputs are size-checked before upload. Use this when you have a specific question about an image; for a general caption or alt text with no question, call describe_image instead.",
+ "description": "Let the agent SEE an image and answer a question about it. Supply the image as `imageUrl` (a public https URL the vision server fetches) OR `image` (raw base64 / a data: URI), and a `prompt` describing what to extract - e.g. \"What objects are in this scene?\", \"Read the text in this screenshot\", \"Is this avatar render rigged correctly?\". Returns the model's answer as `text`, plus the `provider` and `model` that served it (a free NVIDIA NIM lane when available, an automatic paid backstop otherwise - the caller never pays). Analysis only: it does not store or mutate anything. Accepts JPEG, PNG, WebP, or GIF up to 12 MB; base64 inputs are size-checked before upload. Use this when you have a specific question about an image; for a general caption or alt text with no question, call describe_image instead.",
"whenToUse": "Use this when you have a specific question about an image; for a general caption or alt text with no question, call describe_image instead.",
"server": {
"id": "vision-mcp",
@@ -39218,7 +39391,7 @@
"type": "integer",
"minimum": 16,
"maximum": 2048,
- "description": "Maximum tokens in the answer (16–2048). Higher = longer, more detailed reads. Default 512."
+ "description": "Maximum tokens in the answer (16 - 2048). Higher = longer, more detailed reads. Default 512."
}
},
"required": [
@@ -39233,7 +39406,7 @@
{
"name": "describe_image",
"title": "Describe an image in natural language",
- "description": "Get a plain-language description of an image — ideal for alt text, captions, or a quick \"what is this?\" read when you have no specific question. Supply the image as `imageUrl` (a public https URL) OR `image` (raw base64 / data: URI). Use `detail` to pick brief / standard / detailed, and `focus` to steer the description toward something specific (e.g. \"the clothing\", \"any visible text\"). Returns the prose as `description`, plus the `provider` and `model` that served it (free NVIDIA NIM first, automatic paid backstop otherwise, so the caller never pays). Read-only; accepts JPEG, PNG, WebP, or GIF up to 12 MB. Use this for alt text or a caption when you have no particular question; to ask something specific about the image, call analyze_image instead.",
+ "description": "Get a plain-language description of an image - ideal for alt text, captions, or a quick \"what is this?\" read when you have no specific question. Supply the image as `imageUrl` (a public https URL) OR `image` (raw base64 / data: URI). Use `detail` to pick brief / standard / detailed, and `focus` to steer the description toward something specific (e.g. \"the clothing\", \"any visible text\"). Returns the prose as `description`, plus the `provider` and `model` that served it (free NVIDIA NIM first, automatic paid backstop otherwise, so the caller never pays). Read-only; accepts JPEG, PNG, WebP, or GIF up to 12 MB. Use this for alt text or a caption when you have no particular question; to ask something specific about the image, call analyze_image instead.",
"whenToUse": "Use this for alt text or a caption when you have no particular question; to ask something specific about the image, call analyze_image instead.",
"server": {
"id": "vision-mcp",
@@ -39285,7 +39458,7 @@
"detailed"
],
"default": "standard",
- "description": "How much description to return: brief (one sentence), standard (2–3 sentences), or detailed (a full paragraph)."
+ "description": "How much description to return: brief (one sentence), standard (2 - 3 sentences), or detailed (a full paragraph)."
},
"focus": {
"type": "string",
@@ -39302,7 +39475,7 @@
{
"name": "get_vision_status",
"title": "Vision availability + accepted formats",
- "description": "Check whether the three.ws vision pipeline is live on the target deployment and which image formats it accepts. Returns `configured` (true when at least one VLM provider — a free NVIDIA NIM lane or the paid backstop — can serve a request) and `image_types` (the accepted MIME types). Use this before calling analyze_image / describe_image so the agent can decide whether to offer a \"describe this image\" action. No image, no key, no cost.",
+ "description": "Check whether the three.ws vision pipeline is live on the target deployment and which image formats it accepts. Returns `configured` (true when at least one VLM provider - a free NVIDIA NIM lane or the paid backstop - can serve a request) and `image_types` (the accepted MIME types). Use this before calling analyze_image / describe_image so the agent can decide whether to offer a \"describe this image\" action. No image, no key, no cost.",
"whenToUse": "Use this before calling analyze_image / describe_image so the agent can decide whether to offer a \"describe this image\" action.",
"server": {
"id": "vision-mcp",
@@ -39443,7 +39616,7 @@
{
"name": "inspect_endpoint",
"title": "Inspect an x402 endpoint (price + requirements, no payment)",
- "description": "Fetch an x402 endpoint and return its 402 payment requirements — every accepted scheme, network, asset, price and pay-to address — WITHOUT paying. If the endpoint is free, returns its result instead. No signer required. Use this to learn the cost before pay_and_call.",
+ "description": "Fetch an x402 endpoint and return its 402 payment requirements - every accepted scheme, network, asset, price and pay-to address - WITHOUT paying. If the endpoint is free, returns its result instead. No signer required. Use this to learn the cost before pay_and_call.",
"whenToUse": "Use this to learn the cost before pay_and_call.",
"server": {
"id": "x402-mcp",
@@ -39546,7 +39719,7 @@
},
"session_token": {
"type": "string",
- "description": "three.ws Payment Session token (pss_…). When provided, the platform wallet pays — no local key needed. Overrides `secret`."
+ "description": "three.ws Payment Session token (pss_…). When provided, the platform wallet pays - no local key needed. Overrides `secret`."
},
"token": {
"type": "string",
@@ -39555,7 +39728,7 @@
"three"
],
"default": "usdc",
- "description": "Settlement token. \"usdc\" (default) or \"three\" — the $THREE platform token; the endpoint must advertise it. Ignored when session_token is set."
+ "description": "Settlement token. \"usdc\" (default) or \"three\" - the $THREE platform token; the endpoint must advertise it. Ignored when session_token is set."
},
"max_usd": {
"type": "number",
diff --git a/public/tools.json b/public/tools.json
index 1b30cfff9..365cd6cd5 100644
--- a/public/tools.json
+++ b/public/tools.json
@@ -4343,7 +4343,7 @@
"category": "launch",
"safety": "write",
"price": 0,
- "whenToUse": "Call this before launching a coin — pass the returned uri to the launch-agent endpoint or the studio launch flow.",
+ "whenToUse": "Call this before launching a coin: pass the returned uri to the launch-agent endpoint or the studio launch flow.",
"page": "https://three.ws/mcp-tools/pump-fun-mcp/pumpfun_upload_metadata"
},
{
@@ -4529,7 +4529,7 @@
{
"name": "restyle_material",
"server": "three-ws-mcp-server",
- "title": "Restyle a 3D model’s materials — AI PBR restyle or seeded colorway variants",
+ "title": "Restyle a 3D model's materials: AI PBR restyle or seeded colorway variants",
"category": "utility",
"safety": "write",
"price": 0.05,
@@ -4559,7 +4559,7 @@
{
"name": "agent_hire_discover",
"server": "three-ws-mcp-server",
- "title": "Agent hire — discover ($0.01)",
+ "title": "Agent hire: discover ($0.01)",
"category": "utility",
"safety": "read",
"price": 0.01,
@@ -4763,7 +4763,7 @@
"category": "intelligence",
"safety": "read",
"price": 0,
- "whenToUse": "Use it for situational awareness — what agents, coins, and players are active right now.",
+ "whenToUse": "Use it for situational awareness, what agents, coins, and players are active right now.",
"page": "https://three.ws/mcp-tools/activity-mcp/get_feed_events"
},
{
@@ -4793,7 +4793,7 @@
"category": "agents",
"safety": "read",
"price": 0,
- "whenToUse": "Use this to verify another agent before coordinating with it — confirm it is registered, active, and what it claims to do.",
+ "whenToUse": "Use this to verify another agent before coordinating with it, confirm it is registered, active, and what it claims to do.",
"page": "https://three.ws/mcp-tools/agenc-mcp/get_agent"
},
{
@@ -4813,7 +4813,7 @@
"category": "x402",
"safety": "read",
"price": 0,
- "whenToUse": "Use this to discover paid work an agent can earn by calling — the x402 complement to the on-chain task marketplace.",
+ "whenToUse": "Use this to discover paid work an agent can earn by calling, the x402 complement to the on-chain task marketplace.",
"page": "https://three.ws/mcp-tools/agenc-mcp/query_x402_services"
},
{
@@ -5033,7 +5033,7 @@
"category": "intelligence",
"safety": "read",
"price": 0,
- "whenToUse": "Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes — to see both what fired and how it was delivered.",
+ "whenToUse": "Use this to review what fired; pair it with list_alert_rules, whose `recent_deliveries` shows per-channel send outcomes, to see both what fired and how it was delivered.",
"page": "https://three.ws/mcp-tools/alerts-mcp/get_alert_history"
},
{
@@ -6409,7 +6409,7 @@
{
"name": "get_portfolio_summary",
"server": "portfolio-mcp",
- "title": "My agents’ live portfolio (holdings + USD value)",
+ "title": "My agents' live portfolio (holdings + USD value)",
"category": "wallet",
"safety": "write",
"price": 0,
@@ -6453,7 +6453,7 @@
"category": "wallet",
"safety": "read",
"price": 0,
- "whenToUse": "Use it to confirm the agent’s own signing wallet before a send_transfer, or to check any address.",
+ "whenToUse": "Use it to confirm the agent's own signing wallet before a send_transfer, or to check any address.",
"page": "https://three.ws/mcp-tools/portfolio-mcp/get_wallet_balances"
},
{
diff --git a/scripts/build-mcp-catalog.mjs b/scripts/build-mcp-catalog.mjs
index 623385c9f..d455a0460 100644
--- a/scripts/build-mcp-catalog.mjs
+++ b/scripts/build-mcp-catalog.mjs
@@ -442,9 +442,12 @@ async function build() {
}
const { catalog, toolsIndex } = await build();
+// Tool descriptions are authored in many files; the published feeds must never carry the dashes
+// the repo bans, so normalize at the single point where they are serialized.
+const plain = (json) => json.replace(/\s?[\u2014\u2013]\s?/g, ' - ').replace(/[\u2018\u2019]/g, "'");
const outputs = [
- [OUT, `${JSON.stringify(catalog, null, '\t')}\n`],
- [TOOLS_OUT, `${JSON.stringify(toolsIndex, null, '\t')}\n`],
+ [OUT, plain(`${JSON.stringify(catalog, null, '\t')}\n`)],
+ [TOOLS_OUT, plain(`${JSON.stringify(toolsIndex, null, '\t')}\n`)],
];
if (process.argv.includes('--check')) {