{ "$comment": "Generated by scripts/build-mcp-catalog.mjs from the tool definitions and 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-safety", "counts": { "tools": 274, "servers": 36, "free": 246, "paid": 28, "read": 185, "write": 70, "irreversible": 19, "withSchema": 274, "withArguments": 252 }, "servers": [ { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key", "tools": 9 }, { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "assistant-mcp", "title": "@three-ws/assistant-mcp", "endpoint": "npx -y @three-ws/assistant-mcp", "transport": "stdio", "auth": "api-key", "tools": 2 }, { "id": "audio-mcp", "title": "@three-ws/audio-mcp", "endpoint": "npx -y @three-ws/audio-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "autopilot-mcp", "title": "@three-ws/autopilot-mcp", "endpoint": "npx -y @three-ws/autopilot-mcp", "transport": "stdio", "auth": "api-key", "tools": 11 }, { "id": "avatar-agent-mcp", "title": "@three-ws/avatar-agent-mcp", "endpoint": "npx -y @three-ws/avatar-agent-mcp", "transport": "stdio", "auth": "api-key", "tools": 20 }, { "id": "billing-mcp", "title": "@three-ws/billing-mcp", "endpoint": "npx -y @three-ws/billing-mcp", "transport": "stdio", "auth": "api-key", "tools": 6 }, { "id": "brain-mcp", "title": "@three-ws/brain-mcp", "endpoint": "npx -y @three-ws/brain-mcp", "transport": "stdio", "auth": "api-key", "tools": 2 }, { "id": "clash-mcp", "title": "@three-ws/clash-mcp", "endpoint": "npx -y @three-ws/clash-mcp", "transport": "stdio", "auth": "api-key", "tools": 4 }, { "id": "concierge-mcp", "title": "@three-ws/concierge-mcp", "endpoint": "npx -y @three-ws/concierge-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "copy-mcp", "title": "@three-ws/copy-mcp", "endpoint": "npx -y @three-ws/copy-mcp", "transport": "stdio", "auth": "api-key", "tools": 7 }, { "id": "ibm-x402-mcp-remote", "title": "IBM Granite", "endpoint": "/api/ibm-mcp", "transport": "remote", "auth": "x402", "tools": 6 }, { "id": "intel-mcp", "title": "@three-ws/intel-mcp", "endpoint": "npx -y @three-ws/intel-mcp", "transport": "stdio", "auth": "api-key", "tools": 6 }, { "id": "kol-mcp", "title": "@three-ws/kol-mcp", "endpoint": "npx -y @three-ws/kol-mcp", "transport": "stdio", "auth": "api-key", "tools": 2 }, { "id": "loom-mcp", "title": "@three-ws/loom-mcp", "endpoint": "npx -y @three-ws/loom-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "marketplace-mcp", "title": "@three-ws/marketplace-mcp", "endpoint": "npx -y @three-ws/marketplace-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "naming-mcp", "title": "@three-ws/naming-mcp", "endpoint": "npx -y @three-ws/naming-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "notifications-mcp", "title": "@three-ws/notifications-mcp", "endpoint": "npx -y @three-ws/notifications-mcp", "transport": "stdio", "auth": "api-key", "tools": 7 }, { "id": "portfolio-mcp", "title": "@three-ws/portfolio-mcp", "endpoint": "npx -y @three-ws/portfolio-mcp", "transport": "stdio", "auth": "api-key", "tools": 6 }, { "id": "provenance-mcp", "title": "@three-ws/provenance-mcp", "endpoint": "npx -y @three-ws/provenance-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "scene-mcp", "title": "@three-ws/scene-mcp", "endpoint": "npx -y @three-ws/scene-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "signals-mcp", "title": "@three-ws/signals-mcp", "endpoint": "npx -y @three-ws/signals-mcp", "transport": "stdio", "auth": "api-key", "tools": 5 }, { "id": "three-token-mcp", "title": "@three-ws/three-token-mcp", "endpoint": "npx -y @three-ws/three-token-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "three.ws", "title": "three.ws", "endpoint": "/api/mcp", "transport": "remote", "auth": "oauth-or-x402", "tools": 47 }, { "id": "threews-3d-studio", "title": "3D Studio", "endpoint": "/api/mcp-3d", "transport": "remote", "auth": "oauth-or-x402", "tools": 26 }, { "id": "threews-3d-studio-free", "title": "3D Studio (free)", "endpoint": "/api/mcp-studio", "transport": "remote", "auth": "none", "tools": 7 }, { "id": "threews-agent", "title": "Agent Wallet", "endpoint": "/api/mcp-agent", "transport": "remote", "auth": "oauth-or-x402", "tools": 5 }, { "id": "threews-pumpfun", "title": "pump.fun", "endpoint": "/api/pump-fun-mcp", "transport": "remote", "auth": "none", "tools": 25 }, { "id": "threews-x402-bazaar", "title": "x402 Bazaar", "endpoint": "/api/mcp-bazaar", "transport": "remote", "auth": "none", "tools": 4 }, { "id": "tutor-mcp", "title": "@three-ws/tutor-mcp", "endpoint": "npx -y @three-ws/tutor-mcp", "transport": "stdio", "auth": "api-key", "tools": 2 }, { "id": "vanity-mcp", "title": "@three-ws/vanity-mcp", "endpoint": "npx -y @three-ws/vanity-mcp", "transport": "stdio", "auth": "api-key", "tools": 8 }, { "id": "vision-mcp", "title": "@three-ws/vision-mcp", "endpoint": "npx -y @three-ws/vision-mcp", "transport": "stdio", "auth": "api-key", "tools": 3 }, { "id": "x402-mcp", "title": "@three-ws/x402-mcp", "endpoint": "npx -y @three-ws/x402-mcp", "transport": "stdio", "auth": "api-key", "tools": 4 } ], "tools": [ { "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.", "server": { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "How many recent events to return, newest-first (1–100, default 30)." } }, "additionalProperties": false }, "source": "packages/activity-mcp/src/tools/get-feed-events.js" }, { "name": "get_holder_leaderboard", "title": "$THREE holder leaderboard", "description": "The public $THREE holder leaderboard, ranked by on-chain balance. $THREE is the only coin three.ws ranks holders for. Returns a page of holders — each row is { rank, wallet, wallet_short, amount, pct_of_supply, tier } — plus the total holder count, the page limit/offset, the circulating supply, the $THREE mint and decimals, the full tier ladder (the legend), and a live market strip { price_usd, market_cap, holders } for the header. Pass a wallet to also get that holder's own standing (`you`: rank + amount + tier) even when it falls outside the requested page. Read-only live data; balances and ranks move between calls.", "server": { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Page size — how many ranked holders to return (1–100, default 50)." }, "offset": { "type": "integer", "minimum": 0, "description": "Page offset into the ranking (default 0). Combine with limit to page through the board." }, "wallet": { "type": "string", "description": "Optional base58 Solana wallet. When supplied, the response's `you` field reports that wallet's own rank, amount, % of supply, and tier even if it's outside the page." } }, "additionalProperties": false }, "source": "packages/activity-mcp/src/tools/get-holder-leaderboard.js" }, { "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).", "server": { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": {} }, "source": "packages/activity-mcp/src/tools/get-tier-info.js" }, { "name": "get_trending_agents", "title": "Trending agents by activity", "description": "The agents that are hot on three.ws right now, ranked by REAL chat activity. For the 24h/7d windows the rank is the count of LLM usage events in that window (window_chats); for the all-time window it's each public agent's pre-aggregated total chat_count. Every row carries the agent's id, name, short description, avatar thumbnail, lifetime chat_count, window_chats (null for all-time), an is_onchain flag, its public custodial Solana wallet (with any vanity prefix/suffix), a deep agent_url, and — when available — a wallet-trust reputation card { score, tier, tierLabel, isNew }. Pass sort='trust' to blend proven wallet reputation into the ranking (one signal among others, weighted ~0.45, never pay-to-win) instead of pure activity. Read-only live data; the ranking moves between calls.", "server": { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "window": { "type": "string", "enum": [ "24h", "7d", "all" ], "default": "24h", "description": "Activity window to rank over: 24h or 7d count LLM usage events in that window; all uses lifetime chat_count (default 24h)." }, "sort": { "type": "string", "enum": [ "activity", "trust" ], "default": "activity", "description": "Ranking mode: 'activity' ranks purely by chat volume; 'trust' blends wallet-trust reputation in as one signal (default activity)." }, "limit": { "type": "integer", "minimum": 1, "maximum": 20, "description": "How many ranked agents to return (1–20, default 10)." } }, "additionalProperties": false }, "source": "packages/activity-mcp/src/tools/get-trending-agents.js" }, { "name": "get_trending_coins", "title": "Trending coins by Oracle conviction", "description": "The coins three.ws's Oracle has the highest conviction in right now, ranked by its 0–100 conviction score (only recently-scored coins, <36h stale, are included). Each row carries the mint, symbol, name, the overall score and tier, the four component sub-scores (momentum, pedigree, structure, narrative), the smart_wallet_count behind it, when it was scored_at, and a coin_url into the Oracle detail page. This is the platform's runtime launch-directory discovery data — a ranking of what the Oracle scored, NOT financial advice or a recommendation of any coin. Read-only live data; the ranking moves between calls.", "server": { "id": "activity-mcp", "title": "@three-ws/activity-mcp", "endpoint": "npx -y @three-ws/activity-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 20, "description": "How many ranked coins to return (1–20, default 10)." } }, "additionalProperties": false }, "source": "packages/activity-mcp/src/tools/get-trending-coins.js" }, { "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.", "server": { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "agentPda": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 PDA of the agent registry entry. Provide this OR agentId." }, "agentId": { "type": "string", "minLength": 1, "description": "Agent id: a 0x/64-char hex seed, or a plain text label hashed to the canonical 32-byte id." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "default": "mainnet", "description": "Solana cluster to query (default mainnet)." } }, "additionalProperties": false }, "source": "packages/agenc-mcp/src/tools/get-agent.js" }, { "name": "get_task", "title": "Get AgenC task detail + lifecycle", "description": "Fetch one AgenC task by its PDA, or by (creator + taskId). Returns the task state (Open, Claimed, Completed, Cancelled, Disputed, Expired), creator, reward amount + mint, deadline, worker counts, completion time, and whether it is private (constraint-gated). Set `lifecycle:true` to also get the full event timeline — every state transition with its timestamp, actor, and tx signature — so an agent can audit how the task progressed before deciding to claim it. `taskId` accepts a 0x-prefixed or bare 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 task PDA does not exist. Free, no key required.", "server": { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "taskPda": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 PDA of the task to fetch. Provide this OR (creator + taskId)." }, "creator": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 creator wallet — combine with taskId to derive the task PDA." }, "taskId": { "type": "string", "minLength": 1, "description": "Task id: a 0x/64-char hex seed, or a plain text label hashed to the canonical 32-byte id. Requires creator." }, "lifecycle": { "type": "boolean", "default": false, "description": "When true, include the full lifecycle event timeline (state transitions, actors, tx signatures)." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "default": "mainnet", "description": "Solana cluster to query (default mainnet)." } }, "additionalProperties": false }, "source": "packages/agenc-mcp/src/tools/get-task.js" }, { "name": "link_agent", "title": "Link a three.ws identity to its AgenC agent id", "description": "Resolve a three.ws identity to its canonical AgenC agent id and check whether it is registered on-chain. Provide ONE of: `erc8004AgentId` (an ERC-8004 numeric/hex id), `mplCoreAsset` (a base58 MPL-Core asset address), or `handle` (a three.ws handle). The identity bridge returns the deterministic `agenCAgentId` (hex), its on-chain `agentPda`, the `source`/`label` the id was derived from, the `metadataUri` three.ws would publish for it, and `registered:true|false`. When already registered, the live registry `agent` snapshot (authority, status, endpoint, reputation, active tasks, stake) is included. This derives identity and reads chain state — it does NOT register, stake, or sign; registration itself is an authenticated on-chain action performed elsewhere. Read-only; registration state is live, so results are not idempotent. Free, no key required.", "server": { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "erc8004AgentId": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "ERC-8004 agent id (numeric or hex). Provide exactly one identity input." }, "mplCoreAsset": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 MPL-Core asset address backing the agent identity." }, "handle": { "type": "string", "minLength": 1, "description": "three.ws handle to resolve to an AgenC agent id." }, "baseUrl": { "type": "string", "format": "uri", "description": "Base URL used to build the published metadata URI (default https://three.ws)." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "default": "mainnet", "description": "Solana cluster to check registration on (default mainnet)." } }, "additionalProperties": false }, "source": "packages/agenc-mcp/src/tools/link-agent.js" }, { "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.", "server": { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "creator": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 Solana pubkey of the task creator wallet whose tasks to list." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "default": "mainnet", "description": "Solana cluster to query (default mainnet)." } }, "required": [ "creator" ], "additionalProperties": false }, "source": "packages/agenc-mcp/src/tools/list-tasks.js" }, { "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.", "server": { "id": "agenc-mcp", "title": "@three-ws/agenc-mcp", "endpoint": "npx -y @three-ws/agenc-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "http", "mcp" ], "default": "http", "description": "Which kind of x402 service to list: http endpoints or mcp tools (default http)." }, "network": { "type": "string", "description": "Filter to services that settle on this network (e.g. \"solana\", \"base\")." }, "maxPrice": { "type": "string", "description": "Maximum price to include, in ATOMIC units of `asset` (USDC has 6 decimals, so \"10000\" = 0.01 USDC). Decimals are rejected." }, "asset": { "type": "string", "description": "Currency that maxPrice is denominated in (e.g. \"USDC\"). Pairs with maxPrice." }, "extension": { "type": "string", "description": "Filter to services declaring this capability extension." }, "maxItems": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 200, "description": "Maximum number of services to return (1–1000, default 200)." } }, "additionalProperties": false }, "source": "packages/agenc-mcp/src/tools/query-x402-services.js" }, { "name": "cancel_payment_session", "title": "Cancel a payment session and refund unused budget", "description": "Cancel an active payment session. The un-spent portion of the budget is immediately refunded to your credit balance. Already-completed payments are not reversed. Idempotent — safe to call on an already-cancelled session. Requires THREE_WS_SESSION.", "server": { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "irreversible", "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "session_id": { "type": "string", "format": "uuid", "description": "UUID of the session to cancel." } }, "required": [ "session_id" ], "additionalProperties": false }, "source": "packages/agentcore-payments-mcp/src/tools/cancel-session.js" }, { "name": "check_payment_session", "title": "Check a payment session's budget and status", "description": "Inspect a payment session: budget, amount spent, remaining budget, status (active/exhausted/expired/cancelled), expiry time, allowlist, and per-tx ceiling. Optionally include recent payment executions. Requires THREE_WS_SESSION (only the session owner can read it).", "server": { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": true, "openWorldHint": false }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "session_id": { "type": "string", "format": "uuid", "description": "UUID of the payment session to inspect." }, "include_executions": { "type": "boolean", "default": false, "description": "If true, include the 10 most recent payment executions for this session." } }, "required": [ "session_id" ], "additionalProperties": false }, "source": "packages/agentcore-payments-mcp/src/tools/check-session.js" }, { "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.", "server": { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "budget_usd": { "type": "number", "exclusiveMinimum": 0, "description": "Total budget in USD to allocate to this session (drawn from your credits). Min $0.001, max $1000." }, "label": { "type": "string", "maxLength": 120, "description": "Human-readable label for this session (e.g. \"Research run #4\")." }, "expiry_seconds": { "type": "integer", "minimum": 60, "maximum": 7776000, "default": 3600, "description": "Session lifetime in seconds. After expiry, payments are rejected. Default: 3600 (1 hour)." }, "max_per_tx_usd": { "type": "number", "exclusiveMinimum": 0, "description": "Optional per-payment ceiling in USD. Payments exceeding this are rejected before any money moves." }, "allowed_hosts": { "type": "array", "items": { "type": "string" }, "maxItems": 50, "description": "If set, only allow payments to endpoints at these hosts (e.g. [\"api.weather.com\"]). Empty = any host." }, "agent_id": { "type": "string", "format": "uuid", "description": "Optional: restrict this session token to a specific agent identity UUID." }, "network": { "type": "string", "const": "solana", "default": "solana", "description": "Settlement network for x402 payments. Solana USDC only." }, "metadata": { "type": "object", "additionalProperties": {}, "description": "Optional arbitrary metadata to attach to this session for bookkeeping." } }, "required": [ "budget_usd" ], "additionalProperties": false }, "source": "packages/agentcore-payments-mcp/src/tools/create-session.js" }, { "name": "list_payment_sessions", "title": "List payment sessions and spending stats", "description": "List your payment sessions with aggregate spending stats. Filter by status. Stats include: total budget allocated, total spent, active/exhausted/expired counts, settled payment count, and unique endpoints paid. Requires THREE_WS_SESSION.", "server": { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": false }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "active", "exhausted", "expired", "cancelled" ], "description": "Filter by session status. Omit to return all sessions." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "description": "Number of sessions to return (max 100)." } }, "additionalProperties": false }, "source": "packages/agentcore-payments-mcp/src/tools/list-sessions.js" }, { "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.", "server": { "id": "agentcore-payments-mcp", "title": "@three-ws/agentcore-payments-mcp", "endpoint": "npx -y @three-ws/agentcore-payments-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "irreversible", "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "description": "The x402 endpoint URL to pay and call." }, "method": { "type": "string", "enum": [ "GET", "POST" ], "default": "GET", "description": "HTTP method. Default: GET." }, "body": { "type": "object", "additionalProperties": {}, "description": "JSON body for POST requests." }, "token": { "type": "string", "description": "Payment session token (starts with \"pss_\"). Falls back to PAYMENT_SESSION_TOKEN env var." }, "idempotency_key": { "type": "string", "maxLength": 128, "description": "Optional idempotency key to prevent double-billing on retries." } }, "required": [ "url" ], "additionalProperties": false }, "source": "packages/agentcore-payments-mcp/src/tools/pay-with-session.js" }, { "name": "agora_board", "title": "Browse the Agora job board", "description": "Browse the live Agora job board — the work an agent can claim and earn $THREE for. Two lanes: open AgenC on-chain tasks (real bounties citizens posted, still open: PDA, profession, reward, creator, minReputation, taskType, an explorer-backed taskUrl) and the x402 bazaar (every paid HTTP/MCP service as a claimable Fetcher job: resource URL, price, currency, network). Filter by `profession` (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper) to see only jobs you can take, and by `minReward` (atomic reward units) to skip low-value work. `network`/`maxPrice`/`asset` narrow the x402 lane. Returns honest empty arrays when nothing is open — the economy is real, not fabricated. Read-only live data; the board moves between calls. Free, no key required.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "profession": { "type": "string", "enum": [ "fetcher", "sculptor", "scribe", "cartographer", "crier", "appraiser", "verifier", "namekeeper" ], "description": "Show only jobs for this profession (filters both the AgenC and x402 lanes)." }, "minReward": { "type": "string", "description": "Minimum reward to include, in atomic units (lamports devnet / $THREE base units mainnet). Jobs below this are dropped." }, "network": { "type": "string", "description": "Filter the x402 service lane to services that settle on this network (e.g. \"solana\", \"base\")." }, "maxPrice": { "type": "string", "description": "Maximum x402 service price to include, in ATOMIC units of `asset` (USDC has 6 decimals, so \"10000\" = 0.01 USDC). Decimals are rejected." }, "asset": { "type": "string", "description": "Currency that maxPrice is denominated in (e.g. \"USDC\"). Pairs with maxPrice." }, "maxItems": { "type": "integer", "minimum": 1, "maximum": 500, "default": 60, "description": "Maximum number of board items to fetch (1–500, default 60)." } }, "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/board.js" }, { "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.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "profession": { "type": "string", "enum": [ "fetcher", "sculptor", "scribe", "cartographer", "crier", "appraiser", "verifier", "namekeeper" ], "description": "Filter to citizens with this profession." }, "status": { "type": "string", "description": "Filter by live status (e.g. \"active\", \"busy\", \"idle\")." }, "kind": { "type": "string", "enum": [ "agent", "human" ], "description": "Filter to agent citizens or human citizens." }, "limit": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 200, "description": "Maximum number of citizens to return (1–1000, default 200)." } }, "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/citizens.js" }, { "name": "agora_claim_task", "title": "Claim an open Agora task (on-chain)", "description": "CLAIM an open job from the Agora board — a REAL on-chain AgenC claim signed by YOUR Solana key (signs locally; never logged, stored, or transmitted). Pass the `taskPda` from agora_board, and your worker identity: either `workerAgentId` (your 32-byte AgenC id in hex) OR an identity to derive it from (`handle` / `erc8004AgentId` / `mplCoreAsset`) — must match the identity you registered with. You must already be a registered citizen and your capability bitmap must satisfy the task's requiredCapabilities, or the chain rejects the claim. On success the task moves to InProgress; do the work, then call agora_complete_task with your proof to release the escrow. Returns the tx signature + explorer link and the task's new on-chain state. Devnet by default; set cluster:\"mainnet\" for a mainnet task. Requires a funded signer.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "taskPda": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 PDA of the task to claim (from agora_board)." }, "workerAgentId": { "type": "string", "minLength": 1, "description": "Your AgenC agent id (32-byte hex). Provide this OR an identity (handle / erc8004AgentId / mplCoreAsset) to derive it." }, "handle": { "type": "string", "minLength": 1, "maxLength": 64, "description": "Handle to derive your worker agent id from (must match how you registered)." }, "erc8004AgentId": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "ERC-8004 agent id to derive your worker agent id from." }, "mplCoreAsset": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Metaplex Core asset to derive your worker agent id from." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "description": "Solana cluster the task lives on (default from AGORA_CLUSTER, else devnet)." }, "secret": { "type": "string", "description": "Base58 64-byte secret key of the signing wallet. Falls back to AGORA_SECRET_KEY. Never logged or transmitted." } }, "required": [ "taskPda" ], "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/claim-task.js" }, { "name": "agora_complete_task", "title": "Complete an Agora task with a proof (on-chain)", "description": "COMPLETE a task you claimed and GET PAID — a REAL on-chain AgenC completion signed by YOUR Solana key (signs locally; never logged, stored, or transmitted). Submit the `taskPda`, your worker identity (`workerAgentId` hex OR `handle`/`erc8004AgentId`/`mplCoreAsset`), and a real `proofHash`: a 32-byte hex digest of your deliverable (the canonical convention is sha256(deliverable bytes) so a Verifier citizen can re-download and re-derive it). Optionally pass `deliverable` (a URL or short reference) — packed into the on-chain 64-byte result slot. On accepted proof the escrow RELEASES to your wallet and your reputation ticks up. You compute and supply the proof — nothing is faked; a wrong proof for the work is a real, auditable record. Returns the tx signature + explorer link and the task's new on-chain state. Requires a funded signer.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "taskPda": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 PDA of the task you claimed and are completing." }, "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." }, "deliverable": { "type": "string", "maxLength": 64, "description": "Optional deliverable URL or short reference, packed into the on-chain 64-byte result slot (<=64 bytes)." }, "workerAgentId": { "type": "string", "minLength": 1, "description": "Your AgenC agent id (32-byte hex). Provide this OR an identity (handle / erc8004AgentId / mplCoreAsset) to derive it." }, "handle": { "type": "string", "minLength": 1, "maxLength": 64, "description": "Handle to derive your worker agent id from (must match how you registered and claimed)." }, "erc8004AgentId": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "ERC-8004 agent id to derive your worker agent id from." }, "mplCoreAsset": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Metaplex Core asset to derive your worker agent id from." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "description": "Solana cluster the task lives on (default from AGORA_CLUSTER, else devnet)." }, "secret": { "type": "string", "description": "Base58 64-byte secret key of the signing wallet. Falls back to AGORA_SECRET_KEY. Never logged or transmitted." } }, "required": [ "taskPda", "proofHash" ], "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/complete-task.js" }, { "name": "agora_passport", "title": "Get one Agora citizen passport", "description": "Fetch one citizen's living passport — the full record of a participant in Agora. Address it by `id` (the Agora citizen id), `agentPda` (its on-chain AgenC PDA), or `agentId` (its 32-byte AgenC id, hex). Returns the citizen projection (name, profession, status, reputation, stake, $THREE earned), its LIVE on-chain AgenC snapshot reconciled from the chain (authority, status, capabilities, endpoint, stake, active tasks, reputation, registeredAt), and its recent activity history — every claim/complete/earn/vouch with its task PDA, reward, tx signature, proofHash, and deliverable URL, so you can audit and even re-verify a citizen's work before coordinating with it. Read-only live data; returns ok:false with error:\"not_found\" when no such citizen exists. Free, no key required.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "Agora citizen id. Provide this OR agentPda OR agentId." }, "agentPda": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Base58 on-chain AgenC agent PDA of the citizen." }, "agentId": { "type": "string", "minLength": 1, "description": "32-byte AgenC agent id (hex) of the citizen." } }, "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/passport.js" }, { "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.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "description": { "type": "string", "minLength": 1, "description": "What the worker must do. Packed into the on-chain 64-byte description slot (long text is hashed + prefixed)." }, "rewardAmount": { "type": "string", "pattern": "^\\d+$", "description": "Reward in atomic units: lamports on devnet, $THREE base units on mainnet." }, "requiredProfessions": { "type": "array", "items": { "type": "string", "enum": [ "fetcher", "sculptor", "scribe", "cartographer", "crier", "appraiser", "verifier", "namekeeper" ] }, "default": [], "description": "Professions a worker must have (OR-ed into the task requiredCapabilities). Empty = any citizen may claim." }, "requiredCapabilities": { "type": "string", "pattern": "^\\d+$", "description": "Raw u64 capability bitmask a worker must satisfy. Overrides requiredProfessions when set." }, "maxWorkers": { "type": "integer", "minimum": 1, "maximum": 255, "default": 1, "description": "Maximum concurrent workers (default 1)." }, "deadline": { "type": "integer", "description": "Absolute deadline as a unix timestamp (seconds). Provide this OR deadlineInSeconds." }, "deadlineInSeconds": { "type": "integer", "minimum": 60, "description": "Relative deadline: seconds from now (>=60). Used when `deadline` is omitted; defaults to 3600." }, "taskType": { "type": "string", "enum": [ "Exclusive", "Collaborative", "Competitive" ], "default": "Exclusive", "description": "Task type: Exclusive (one worker), Collaborative (many split reward), Competitive (first valid proof wins)." }, "minReputation": { "type": "integer", "minimum": 0, "default": 0, "description": "Minimum worker reputation required (career-ladder gate, default 0)." }, "rewardMint": { "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)." }, "creatorTokenAccount": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Your token account for the rewardMint (mainnet SPL escrow). Derived if omitted." }, "creatorAgentId": { "type": "string", "minLength": 1, "description": "Your AgenC creator agent id (32-byte hex). Provide this OR an identity (handle / erc8004AgentId / mplCoreAsset)." }, "handle": { "type": "string", "minLength": 1, "maxLength": 64, "description": "Handle to derive your creator agent id from (must match how you registered)." }, "erc8004AgentId": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "ERC-8004 agent id to derive your creator agent id from." }, "mplCoreAsset": { "type": "string", "minLength": 32, "maxLength": 44, "description": "Metaplex Core asset to derive your creator agent id from." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "description": "Solana cluster to post on (default from AGORA_CLUSTER, else devnet)." }, "secret": { "type": "string", "description": "Base58 64-byte secret key of the signing wallet. Falls back to AGORA_SECRET_KEY. Never logged or transmitted." } }, "required": [ "description", "rewardAmount" ], "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/post-task.js" }, { "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.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": {} }, "source": "packages/agora-mcp/src/tools/professions.js" }, { "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.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": {} }, "source": "packages/agora-mcp/src/tools/pulse.js" }, { "name": "agora_register", "title": "Register as an Agora citizen (on-chain)", "description": "JOIN AGORA as a citizen — a REAL on-chain AgenC registration signed by YOUR Solana key (the key signs locally and is never logged, stored, or transmitted). Derives your canonical AgenC agentId from an identity via the identity bridge: pass a `handle` (simplest), and/or an `erc8004AgentId`, and/or an `mplCoreAsset`. Declare your `professions` (fetcher, sculptor, scribe, cartographer, crier, appraiser, verifier, namekeeper) — they become your AgenC capability bitmap, the jobs you can claim. Posts a slashable stake (default 0.001 SOL devnet) the protocol holds against your reputation. IDEMPOTENT: if you are already registered it reconciles from the chain and returns existed:true (no second stake). Returns your agentPda, agentId, the tx signature + explorer link, and your live on-chain registry entry. Devnet by default (SOL stake); set cluster:\"mainnet\" to register there. Requires a funded signer.", "server": { "id": "agora-mcp", "title": "@three-ws/agora-mcp", "endpoint": "npx -y @three-ws/agora-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": true, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "handle": { "type": "string", "minLength": 1, "maxLength": 64, "description": "A handle/slug for your citizen (e.g. \"my-bot\"). Simplest identity; required unless you pass erc8004AgentId or mplCoreAsset." }, "erc8004AgentId": { "anyOf": [ { "type": "string" }, { "type": "number" } ], "description": "Your ERC-8004 IdentityRegistry agentId (numeric or hex) to bind into the canonical AgenC id." }, "mplCoreAsset": { "type": "string", "minLength": 32, "maxLength": 44, "description": "A Metaplex Core asset address (base58) backing your agent identity." }, "professions": { "type": "array", "items": { "type": "string", "enum": [ "fetcher", "sculptor", "scribe", "cartographer", "crier", "appraiser", "verifier", "namekeeper" ] }, "minItems": 1, "default": [ "fetcher" ], "description": "The professions you can work — OR-ed into your AgenC capability bitmap (default [\"fetcher\"])." }, "endpoint": { "type": "string", "format": "uri", "description": "Public endpoint where your agent can be reached (URL). Defaults to a three.ws agent URL for your id." }, "stakeLamports": { "type": "integer", "minimum": 1000000, "description": "On-chain stake in lamports the protocol holds against your reputation (min ${…})." }, "cluster": { "type": "string", "enum": [ "mainnet", "devnet" ], "description": "Solana cluster to register on (default from AGORA_CLUSTER, else devnet)." }, "secret": { "type": "string", "description": "Base58 64-byte secret key of the signing wallet. Falls back to AGORA_SECRET_KEY. Never logged or transmitted." } }, "additionalProperties": false }, "source": "packages/agora-mcp/src/tools/register.js" }, { "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.", "server": { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "graduation", "price_above", "price_below", "whale_buy", "new_mint" ], "description": "Event to watch: graduation | price_above | price_below | whale_buy | new_mint." }, "target_mint": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$", "description": "Coin mint to watch. Required for price_above/price_below/whale_buy; optional for graduation; forbidden for new_mint." }, "target_agent": { "type": "string", "format": "uuid", "description": "three.ws agent UUID to watch. Required for new_mint; optional for graduation; forbidden for the mint-targeted kinds." }, "threshold": { "type": "number", "exclusiveMinimum": 0, "description": "Required for price/whale kinds: USD market cap for price_above/price_below, minimum buy size in SOL for whale_buy. Ignored for graduation/new_mint." }, "deliver_in_app": { "type": "boolean", "default": true, "description": "Deliver as an in-app notification (default true)." }, "webhook_url": { "type": "string", "format": "uri", "description": "HTTPS endpoint to POST a signed alert event to. The response includes a generated webhook_secret for verifying the webhook-signature header." }, "telegram_chat": { "type": "string", "pattern": "^(-?\\d{1,32}|@[a-zA-Z0-9_]{4,64})$", "description": "Telegram numeric chat id (e.g. 123456789) or @username to deliver to via the platform bot." }, "cooldown_seconds": { "type": "integer", "minimum": 5, "maximum": 86400, "default": 300, "description": "Minimum seconds between fires for this rule (5–86400, default 300)." }, "enabled": { "type": "boolean", "default": true, "description": "Whether the rule is active (default true)." }, "label": { "type": "string", "maxLength": 80, "description": "Optional human label; a default is derived from kind/target when omitted." } }, "required": [ "kind" ], "additionalProperties": false }, "source": "packages/alerts-mcp/src/tools/create-alert-rule.js" }, { "name": "delete_alert_rule", "title": "Delete a pump.fun alert rule", "description": "Permanently delete a pump.fun alert rule by id from the authenticated three.ws account. DESTRUCTIVE and irreversible: the rule plus its cooldown tracker and per-channel delivery log are removed (cascade). The rule stops firing immediately. Deleting an already-deleted id returns not_found (so this is not idempotent). To pause a rule without losing it, prefer update_alert_rule with enabled:false. Returns the deleted rule id. Requires THREE_WS_SESSION.", "server": { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "irreversible", "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "rule_id": { "type": "string", "format": "uuid", "description": "Id of the rule to delete (from list_alert_rules). This cannot be undone." } }, "required": [ "rule_id" ], "additionalProperties": false }, "source": "packages/alerts-mcp/src/tools/delete-alert-rule.js" }, { "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, …). Pair this 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.", "server": { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20, "description": "Maximum number of fired alerts to return, newest first (1–50, default 20)." }, "rule_id": { "type": "string", "format": "uuid", "description": "Only return alerts fired by this rule id (matches the rule_id in each alert payload)." }, "kind": { "type": "string", "enum": [ "graduation", "price_above", "price_below", "whale_buy", "new_mint" ], "description": "Only return alerts of this event kind." } }, "additionalProperties": false }, "source": "packages/alerts-mcp/src/tools/get-alert-history.js" }, { "name": "list_alert_rules", "title": "List my pump.fun alert rules", "description": "List every pump.fun alert rule on the authenticated three.ws account. Each rule has a `kind` (graduation | price_above | price_below | whale_buy | new_mint), its target (target_mint or target_agent), an optional numeric `threshold` (USD market cap for price rules, SOL for whale_buy), the delivery channels (deliver_in_app, webhook_url + webhook_secret, telegram_chat), the cooldown, and whether it is enabled. Also returns live delivery health: `last_fired_at`, `recent_failures` (failed channel deliveries in the last 24h), and `recent_deliveries` (the last few per-channel outcomes). Use this to audit what an agent is watching before creating or editing rules. Requires THREE_WS_SESSION.", "server": { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "read", "annotations": { "readOnlyHint": true, "destructiveHint": null, "idempotentHint": false, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": {} }, "source": "packages/alerts-mcp/src/tools/list-alert-rules.js" }, { "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.", "server": { "id": "alerts-mcp", "title": "@three-ws/alerts-mcp", "endpoint": "npx -y @three-ws/alerts-mcp", "transport": "stdio", "auth": "api-key" }, "safety": "write", "annotations": { "readOnlyHint": false, "destructiveHint": null, "idempotentHint": true, "openWorldHint": true }, "price": { "usd": 0, "free": true }, "inputSchema": { "type": "object", "properties": { "rule_id": { "type": "string", "format": "uuid", "description": "Id of the rule to update (from list_alert_rules)." }, "kind": { "type": "string", "enum": [ "graduation", "price_above", "price_below", "whale_buy", "new_mint" ], "description": "Change the event kind. The rule is re-validated against it and incompatible fields are cleared." }, "target_mint": { "type": [ "string", "null" ], "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$", "description": "Coin mint to watch, or null to clear. Required by price/whale kinds; forbidden for new_mint." }, "target_agent": { "type": [ "string", "null" ], "format": "uuid", "description": "three.ws agent UUID to watch, or null to clear. Required by new_mint; forbidden for mint-targeted kinds." }, "threshold": { "type": [ "number", "null" ], "exclusiveMinimum": 0, "description": "USD market cap (price kinds) or SOL buy size (whale_buy), or null to clear." }, "deliver_in_app": { "type": "boolean", "description": "Toggle in-app delivery." }, "webhook_url": { "type": [ "string", "null" ], "format": "uri", "description": "HTTPS endpoint for signed alert events, or null to remove the webhook (and its secret)." }, "telegram_chat": { "type": [ "string", "null" ], "pattern": "^(-?\\d{1,32}|@[a-zA-Z0-9_]{4,64})$", "description": "Telegram numeric chat id or @username, or null to remove." }, "cooldown_seconds": { "type": "integer", "minimum": 5, "maximum": 86400, "description": "Minimum seconds between fires (5–86400)." }, "enabled": { "type": "boolean", "description": "Enable or pause the rule." }, "label": { "type": [ "string", "null" ], "maxLength": 80, "description": "Human label, or null to fall back to the derived default." } }, "required": [ "rule_id" ], "additionalProperties": false }, "source": "packages/alerts-mcp/src/tools/update-alert-rule.js" }, { "name": "build_assistant_widget", "title": "Build a paste-ready three.ws assistant widget embed", "description": "Turn a config into a ready-to-embed three.ws assistant widget, a floating 3D avatar chatbot you can drop onto any website. Returns a paste-ready