three.ws Marketplace

@three-ws/marketplace-mcp

あらゆる AI エージェントから three.ws のエージェントマーケットプレイスとスキルカタログを閲覧できます。

---

stdio 経由で three.ws マーケットプレイスの閲覧と検索機能をあらゆる AI アシスタントに提供する、Model Context Protocol サーバーです。公開されているエージェントを検索してページを切り替え、ID でエージェントの詳細を確認し、再利用可能なスキルカタログを探索できます。すべて公開 three.ws API を利用します。

API キー、署名者、支払いは不要です。すべての呼び出しは公開されている /api/marketplace および /api/skills エンドポイントにアクセスします。エージェントやスキルの作成・公開は、HTTP API の認証が必要な書き込み経路です。このサーバーが提供するのは閲覧と検索のみです。

インストール

npm install @three-ws/marketplace-mcp

または、npx で実行します（インストール不要）。

npx @three-ws/marketplace-mcp

クイックスタート

Claude Code の場合、1 行で設定できます。

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

Claude Desktop / Cursor の場合（claude_desktop_config.json または mcp.json）。

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

MCP Inspector で機能を確認できます。

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

ツール

ツール	種類	説明
browse_agents	読み取り専用	エージェントマーケットプレイスを検索してページを切り替えます。カテゴリや検索語で絞り込み、並べ替え、カーソルでページネーションできます。
agent_detail	読み取り専用	ID で公開済みエージェントを 1 件取得します（システムプロンプト、機能、作成者、評価、スキルの価格、アバター）。
agent_categories	読み取り専用	エージェントのカテゴリと、各カテゴリの公開済みエージェント数、および全体の合計を一覧表示します。
browse_skills	読み取り専用	スキルカタログを検索してページを切り替えます。検索語やカテゴリで絞り込み、並べ替え、カーソルでページネーションできます。
skill_categories	読み取り専用	公開スキルが 1 件以上あるスキルカテゴリを、スラッグ、ラベル、件数とともに一覧表示します。

入力パラメーター

browse_agents — category（省略可能なスラッグ）、q（省略可能なフリーテキスト）、sort（recommended | recent | popular | top_rated、既定値は recommended）、limit（1～48、既定値は 24）、cursor（省略可能なページネーションカーソル）。

agent_detail — id（必須：browse_agents のカードにあるエージェントの UUID）。

agent_categories — パラメーターなし。

browse_skills — q（省略可能なフリーテキスト）、category（省略可能なスラッグ）、sort（popular | new | az、既定値は popular）、limit（1～50、既定値は 20）、cursor（省略可能なページネーションカーソル）。

skill_categories — パラメーターなし。

例

// 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"
}

next_cursor を cursor として渡すと、次のページを取得できます。

使用例

実行可能な例は examples/ にあります。

node examples/list-tools.mjs            # every tool with its full input schema
node examples/browse-marketplace.mjs    # categories + agents + detail + skills, live

どちらの例も、このサーバーを stdio 経由で起動し、公開カタログの最新データを読み込みます。ここにあるすべてのツールは読み取り専用なので、公開や購入はできません。出力例については examples/README.md を参照してください。

要件

• Node.js >= 20。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。詳しくはLICENSEをご覧ください。

---

_{three.ws SDK スイートの一部です — 3D AI エージェント、オンチェーン ID、エージェントによる決済。
ウェブサイト · 変更履歴 · GitHub}