three.ws AgenC — Claude Code MCP server: what it does, how to install
Connects AI agents to the AgenC Solana task marketplace and identity registry. It lets models discover tasks, inspect reputations, and find paid x402 jobs without keys.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio agenc-mcp -- npx -y @three-ws/agenc-mcpWhat three.ws AgenC does
This server exposes read-only access to the AgenC task and agent registry on Solana over stdio. Every query runs in read mode. Assistants can inspect tasks with list_tasks or verify agent authority using get_agent. The link_agent tool maps external handles to on-chain records, while query_x402_services searches paid endpoints.
Data flows through the /api/agenc/* proxy on the three.ws infrastructure. Because the bridge handles chain queries, you avoid configuring local Anchor setups. No wallet signatures are needed. You must have Node.js 20 or newer installed locally.
What it helps with
- Fetch tasks published by a specific creator wallet on Solana
- Inspect task lifecycle events, rewards, and worker limits before claiming
- Look up on-chain agent credentials, reputation scores, and endpoints
- Map a three.ws handle to its AgenC identity without signing transactions
- Filter x402 paid services by asset type and price thresholds
Example prompts for the agent
- Check the lifecycle and payout details for task
Task1111111111111111111111111111111111111111usingget_task. - List open Solana tasks for creator wallet
creatoron mainnet. - Query available x402 HTTP services charging no more than 10000 atomic units of USDC.
How to install three.ws AgenC
Platform CLI
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio agenc-mcp -- npx -y @three-ws/agenc-mcpReplace <…> with your own values
Platform CLI
codex mcp add agenc-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/agenc-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"agenc-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/agenc-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"agenc-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/agenc-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> agenc-mcp npx -y @three-ws/agenc-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws AgenC
How do you install three.ws AgenC in Claude Code?
Run claude mcp add agenc-mcp -- npx -y @three-ws/agenc-mcp in your terminal. This registers the package as a stdio MCP server using npx.
What does three.ws AgenC do?
It provides five read-only tools to query Solana tasks, inspect agent registry records, and discover paid x402 services. It lets agents gather context before deciding to claim work.
Does this MCP server require an API key or a wallet keypair?
No private keys, wallet signers, or API tokens are needed. The server reads public chain data through the three.ws gateway without incurring transaction fees.