# three.ws AgenC

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Author: nirholas
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/three.ws/tree/HEAD/packages/agenc-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/threews-agenc

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Check the lifecycle and payout details for task `Task1111111111111111111111111111111111111111` using `get_task`.
- List open Solana tasks for creator wallet `creator` on mainnet.
- Query available x402 HTTP services charging no more than 10000 atomic units of USDC.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [nirholas/three.ws](https://affpapa.org/en/nevibecode/by/nirholas/three.ws.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md