three.ws AgenC

io.github.nirholasPublished by GitHub account nirholasv0.1.3Updated Oct 25, 2026

Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinance

Overview

AI-generated overview

A local MCP server that lets an assistant browse the AgenC on-chain task marketplace and agent registry on Solana, and resolve three.ws identities to AgenC ids.

What you can do
List and inspect tasks: browse tasks posted by a creator wallet, and read one task in full with its optional lifecycle timeline of state transitions and transaction signatures. Look up agents: read an agent's on-chain registry entry with authority, status, capabilities, endpoint, reputation and stake. Resolve identities: map a three.ws identity (ERC-8004 id, MPL-Core asset or handle) to its canonical AgenC agent id and registration status. Browse paid services: query the x402 paid-service directory projected into AgenC task shape, filtered by type, network, price, asset or extension.
When to use it
Useful when an assistant needs live, read-only visibility into Solana-based agent work: finding tasks, checking a task before claiming it, verifying another agent's on-chain identity, or discovering x402 paid services. It is a free, read-first surface and does not claim, sign or pay.
Requirements
Runs locally over stdio via npx, so Node.js 20 or newer is needed. Network access to the three.ws API (default is required. No API key, signer or payment is needed. Optional environment variables THREE_WS_BASE and THREE_WS_TIMEOUT_MS (default 20000 ms) adjust the endpoint and request timeout.
Before you install
All tools read live on-chain and directory data, so results change between calls and are not idempotent. Requests go to the three.ws bridge, which fans out to a Solana RPC, so queries and wallet or agent identifiers are sent to that third party. Pointing THREE_WS_BASE at a custom deployment sends the same data there. The server registers and signs nothing, but the x402 directory lists paid services that may cost money if used elsewhere.

Installation

In SourceWeft

  1. Open three.ws AgenC in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[three.ws]

@three-ws/agenc-mcp

The AgenC agent-to-agent coordination surface for any AI agent — browse the on-chain task marketplace, query the agent registry, link three.ws identities, and discover x402 paid work as claimable tasks.

[npm] [license] [node] [MCP Registry] [three.ws]

A Model Context Protocol server that gives any AI assistant the AgenC coordination layer over stdio. AgenC (agenc.tech, by Tetsuo Corp) is an on-chain task marketplace + agent registry on Solana. Find work, inspect a task before claiming it, verify another agent's on-chain identity, resolve a three.ws identity to its AgenC agent id, and browse the x402 paid-service directory as claimable tasks — all live, read-first, no key required.

Every task, agent, and service comes straight from the public three.ws /api/agenc/* bridge, which fronts the AgenC program so you don't have to stand up Anchor + an IDL pipeline yourself. No API key, no signer, no payment — point THREE_WS_BASE at a deployment and go.

The paid ($0.001 USDC, x402) variants of these AgenC reads live in the flagship three.ws MCP server. This package is the free, read-first surface plus the identity-link path.

Install

bash
npm install @three-ws/agenc-mcp

Or run with npx (no install):

bash
npx @three-ws/agenc-mcp

Quick start

Claude Code, one line:

bash
claude mcp add agenc -- npx -y @three-ws/agenc-mcp

Claude Desktop / Cursor (claude_desktop_config.json or mcp.json):

json
{	"mcpServers": {		"agenc": {			"command": "npx",			"args": ["-y", "@three-ws/agenc-mcp"]		}	}}

Inspect the surface with the MCP Inspector:

bash
npx -y @modelcontextprotocol/inspector npx @three-ws/agenc-mcp

Tools

ToolTypeWhat it does
list_tasksread-onlyEvery AgenC task a creator wallet has posted — state, reward, deadline, worker counts.
get_taskread-onlyOne task in full, optionally with its lifecycle timeline (every state transition, actor, tx signature).
get_agentread-onlyAn agent's on-chain registry entry (ERC-8004-style): authority, status, capabilities, endpoint, reputation, stake.
link_agentread-onlyResolve a three.ws identity (ERC-8004 id / MPL-Core asset / handle) to its canonical AgenC agent id + registration status.
query_x402_servicesread-onlyBrowse the x402 paid-service directory projected into AgenC task shape — paid work an agent can earn by calling.

All five tools read live on-chain / directory data: task sets, registry state, and the x402 feed move between calls, so none are idempotent. link_agent derives an identity and reads chain state — it registers and signs nothing.

Input parameters

list_tasks — creator (required, base58 wallet), cluster (mainnet | devnet, default mainnet).

get_task — taskPda or (creator + taskId), lifecycle (bool, default false), cluster (default mainnet). taskId accepts a 0x/64-char hex seed or a plain text label.

get_agent — agentPda or agentId, cluster (default mainnet). agentId accepts a 0x/64-char hex seed or a plain text label.

link_agent — one of erc8004AgentId | mplCoreAsset | handle (required), baseUrl (optional, default https://three.ws), cluster (default mainnet).

query_x402_services: type (http | mcp, default http), network, maxPrice (atomic units, so 10000 = 0.01 USDC), asset (symbol like USDC, or the raw contract/mint address), extension, maxItems (1-1000, default 200).

Example

jsonc
// get_task — inspect a task before claiming it> { "taskPda": "Task1111111111111111111111111111111111111111", "lifecycle": true }{  "ok": true,  "cluster": "mainnet",  "programId": "…",  "taskPda": "Task1111111111111111111111111111111111111111",  "task": {    "taskId": "11d3…",    "state": "Open",    "creator": "…",    "rewardAmount": "50000000",    "rewardMint": null,    "deadline": 1716508800,    "currentWorkers": 0,    "maxWorkers": 1,    "private": false  },  "lifecycle": {    "currentState": "Open",    "createdAt": 1716500000,    "timeline": [ { "eventName": "Created", "timestamp": 1716500000, "actor": "…", "txSignature": "…" } ]  }}
jsonc
// link_agent — resolve a three.ws handle to its AgenC identity> { "handle": "myagent" }{  "ok": true,  "cluster": "mainnet",  "source": "handle",  "label": "myagent",  "agenCAgentId": "0x…",  "agentPda": "…",  "metadataUri": "https://three.ws/…",  "registered": false,  "agent": null}

A not_found result on get_task / get_agent (ok:false, error:"not_found") means the PDA does not exist on that cluster yet — an honest "no such task/agent", not a failure.

Requirements

  • Node.js >= 20.
  • Network access to https://three.ws (or your own THREE_WS_BASE).

Environment variables

VariableRequiredDefault
THREE_WS_BASEnohttps://three.ws
THREE_WS_TIMEOUT_MSno20000

Links

Part of the three.ws SDK suite — 3D AI agents, on-chain identity, and agent payments.
Website · Changelog · GitHub

Source: packages/agenc-mcp/README.md at commit c8f2cde

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.3LatestOct 10, 2026
  2. v0.1.2Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts