@three-ws/marketplace-mcp

Browse the three.ws agent marketplace and skills catalog from any AI agent.

license

A Model Context Protocol server that gives any AI assistant browse and discovery of the three.ws marketplace over stdio. Search and page the published agents, drill into one by id, and explore the reusable skills catalog — all from the public three.ws API.

No API key, no signer, no payment — every call hits the public /api/marketplace and /api/skills endpoints. Creating or publishing agents and skills is the authenticated write path on the HTTP API; this server exposes browse/discovery only.

Install

hljs language-bash

npm install @three-ws/marketplace-mcp

Or run with npx (no install):

hljs language-bash

npx @three-ws/marketplace-mcp

Quick start

Claude Code, one line:

hljs language-bash

claude mcp add marketplace -- npx -y @three-ws/marketplace-mcp

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

hljs language-json

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

Inspect the surface with the MCP Inspector:

hljs language-bash

npx -y @modelcontextprotocol/inspector npx @three-ws/marketplace-mcp

Tools

Tool	Type	What it does
`browse_agents`	read-only	Search & page the agent marketplace — filter by category and query, sort, paginate by cursor.
`agent_detail`	read-only	Fetch one published agent by id (system prompt, capabilities, author, ratings, skill prices, avatar).
`agent_categories`	read-only	List agent categories with the count of published agents in each, plus the overall total.
`browse_skills`	read-only	Search & page the skills catalog — filter by query and category, sort, paginate by cursor.
`skill_categories`	read-only	List skill categories that have at least one public skill, each with a slug, label, and count.

Input parameters

browse_agents — category (optional slug), q (optional free text), sort (recommended | recent | popular | top_rated, default recommended), limit (1–48, default 24), cursor (optional pagination cursor).

agent_detail — id (required: the agent's UUID, from a browse_agents card).

agent_categories — no parameters.

browse_skills — q (optional free text), category (optional slug), sort (popular | new | az, default popular), limit (1–50, default 20), cursor (optional pagination cursor).

skill_categories — no parameters.

Example

hljs language-jsonc

// browse_agents
> { "q": "code review", "sort": "top_rated", "limit": 3 }
{
  "ok": true,
  "items": [
    {
      "id": "a1b2c3d4-…",
      "name": "Code Reviewer",
      "description": "Reviews diffs for bugs and style.",
      "category": "programming",
      "tags": ["code", "review"],
      "rating_avg": 4.8,
      "rating_count": 22,
      "views_count": 1340,
      "forks_count": 41,
      "thumbnail_url": "https://…",
      "avatar_glb_url": "https://…"
    }
  ],
  "next_cursor": "3"
}

Pass next_cursor back as cursor to fetch the following page.

Requirements

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

Environment variables

Variable	Required	Default
`THREE_WS_BASE`	no	`https://three.ws`
`THREE_WS_TIMEOUT_MS`	no	`20000`

License

@three-ws/marketplace-mcp

Browse the three.ws agent marketplace and skills catalog from any AI agent.

license

A Model Context Protocol server that gives any AI assistant browse and discovery of the three.ws marketplace over stdio. Search and page the published agents, drill into one by id, and explore the reusable skills catalog — all from the public three.ws API.

Install

hljs language-bash

npm install @three-ws/marketplace-mcp

Or run with npx (no install):

hljs language-bash

npx @three-ws/marketplace-mcp

Quick start

Claude Code, one line:

hljs language-bash

claude mcp add marketplace -- npx -y @three-ws/marketplace-mcp

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

hljs language-json

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

Inspect the surface with the MCP Inspector:

hljs language-bash

npx -y @modelcontextprotocol/inspector npx @three-ws/marketplace-mcp

Tools

Tool	Type	What it does
`browse_agents`	read-only	Search & page the agent marketplace — filter by category and query, sort, paginate by cursor.
`agent_detail`	read-only	Fetch one published agent by id (system prompt, capabilities, author, ratings, skill prices, avatar).
`agent_categories`	read-only	List agent categories with the count of published agents in each, plus the overall total.
`browse_skills`	read-only	Search & page the skills catalog — filter by query and category, sort, paginate by cursor.
`skill_categories`	read-only	List skill categories that have at least one public skill, each with a slug, label, and count.

Input parameters

agent_detail — id (required: the agent's UUID, from a browse_agents card).

agent_categories — no parameters.

skill_categories — no parameters.

Example

hljs language-jsonc

// browse_agents
> { "q": "code review", "sort": "top_rated", "limit": 3 }
{
  "ok": true,
  "items": [
    {
      "id": "a1b2c3d4-…",
      "name": "Code Reviewer",
      "description": "Reviews diffs for bugs and style.",
      "category": "programming",
      "tags": ["code", "review"],
      "rating_avg": 4.8,
      "rating_count": 22,
      "views_count": 1340,
      "forks_count": 41,
      "thumbnail_url": "https://…",
      "avatar_glb_url": "https://…"
    }
  ],
  "next_cursor": "3"
}

Pass next_cursor back as cursor to fetch the following page.

Requirements

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

Environment variables

Variable	Required	Default
`THREE_WS_BASE`	no	`https://three.ws`
`THREE_WS_TIMEOUT_MS`	no	`20000`

nft-marketplace-mcp

@three-ws/marketplace-mcp

Install

Quick start

Tools

Input parameters

Example

Requirements

Environment variables

Links

License

Similar Packages

nft-marketplace-mcp

@three-ws/marketplace-mcp

Install

Quick start

Tools

Input parameters

Example

Requirements

Environment variables

Links

License

Similar Packages