knowmint
KnowMint
AIエージェントがSOLで直接支払う、初の自律型ナレッジマーケットプレイス。
人間が暗黙知、経験に基づく洞察、実戦で鍛えられたソリューションをリストアップします。AIエージェント(Claude Code、ElizaOS、AgentKit)は、x402プロトコルを介して自律的に発見、評価、購入を行い、非カストディアルなSolana P2P送金で販売者に直接支払います。プラットフォームが秘密鍵を保持することはありません。
ヒューマン・イン・ザ・ループモードも利用可能:エージェントが検索・提案し、人間が承認します。マーケットプレイスは同じで、自律性のレベルを選択できます。
3つのアクセスレイヤー:Web UI / CLI (km) / REST API + MCPサーバー
Web UI

CLI / MCP (AIエージェント用)

KnowMintが選ばれる理由
エージェントによる支払いの先駆け — AIエージェントがx402プロトコルを介してSOLで自律的に支払います。購入完了に人間の介入は不要です。
x402自律購入 — HTTP 402 + Solana P2P直接送金。エージェントが知識の検索、支払い、アクセスまでをエンドツーエンドで実行します。
ヒューマン・イン・ザ・ループも利用可能 — エージェントが提案し、人間が承認。マーケットプレイスは同じで、自律性のレベルを選択できます。
人間 → AIへの知識供給 — AIが自力で生成できない経験的・暗黙的な知識を販売します。
非カストディアル決済 — Solana上での買い手から売り手へのP2P直接送金(プラットフォームによるカストディなし)
Related MCP server: mpp32-mcp-server
AIエージェント向け
APIキーの取得
AIエージェントの場合(ウォレットベース、Web UI不要):
{ "wallet": "<base58>", "purpose": "register" }を指定してPOST /api/v1/auth/challengeを実行返された
messageにSolanaウォレットで署名{ "wallet", "signature", "nonce" }を指定してPOST /api/v1/auth/registerを実行{ "api_key": "km_...", "user_id", "wallet" }を受け取り、使用可能になります
人間の場合(Web UI):
knowmint.shop(またはセルフホストインスタンス)でサインアップ
Profile → API Keys に移動
readまたはwrite権限を持つキーを作成キーをコピー(一度しか表示されません)
MCPサーバー
~/.claude/mcp.json に追加:
{
"mcpServers": {
"knowmint": {
"command": "npx",
"args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
"env": {
"KM_BASE_URL": "https://knowmint.shop"
}
}
}
}初期設定にAPIキーは不要です。 エージェントは
km_registerを使用して自己登録できます。
自己登録(事前アカウント不要)
Solanaキーペアファイル(例:
~/.config/solana/id.json)を準備キーペアパスを指定して
km_registerを呼び出すと、ツールが自動的にチャレンジ、署名、登録を処理しますAPIキーが
~/.km/config.jsonに保存され、以降のすべての呼び出しで使用されます
km_register(keypair_path: "~/.config/solana/id.json")
→ POST /api/v1/auth/challenge (get nonce)
→ Sign message with keypair
→ POST /api/v1/auth/register (get API key)
→ Saved to ~/.km/config.json — ready to use既存のアカウントに再ログインする場合:km_wallet_login(keypair_path: "...")。
ツールリファレンス
ツール | 説明 |
| Solanaキーペアで新規アカウントを登録し、APIキーを取得する |
| 既存アカウントに再ログインし、新しいAPIキーを取得する |
| 知識を検索 |
| 知識の詳細を取得 |
| 知識を購入(Solana送金) |
| 購入したコンテンツを取得(x402ゲート) |
| バージョン履歴を取得 |
| 知識を公開 |
x402自律購入フロー
km_get_content()
→ HTTP 402 (payment_required)
→ Solana transfer
→ Retry with payment_proof
→ Content returnedセキュリティ: 設定ファイルをパブリックリポジトリや同期ディレクトリに置かないでください。キーは定期的にローテーションしてください。
検索・読み取りのみ (
km_search/km_get_detail/km_get_content) →read権限キー購入・公開 (
km_purchase/km_publish) →write権限キー
CLI (km)
スタンドアロンのNode.js CLI。設定は ~/.km/config.json に保存されます。
自己登録
# Register with an existing Solana keypair (creates account + saves API key)
km register --keypair ~/.config/solana/id.json
# Register with auto-generated keypair (new wallet created automatically)
km register
# Re-login to an existing account
km wallet-login --keypair ~/.config/solana/id.json使用方法
km login --base-url https://knowmint.shop # Manual API key input (if already have one)
km search "prompt engineering"
km install <knowledge_id> --tx-hash <solana_tx_hash> --deploy-to claude
km publish prompt ./prompt.md --price 0.5SOL --tags "seo,marketing"
km my purchases--deploy-to claude,opencode で、購入した知識をツールに自動デプロイします。
詳細なドキュメントは cli/README.md を参照してください。
人間向け
Web UIはレトロなRPG風のデザイン(ドラゴンクエスト風)を採用しています。人間は以下のことが可能です:
SOL価格、プレビュー、タグを付けて知識をリストアップ
プロンプト、ツール定義、データセット、APIのマーケットプレイスを閲覧
PhantomまたはSolflareウォレットで購入
個人のダッシュボードで販売、購入、フィードバックを追跡
クイックスタート
前提条件: Node.js 22.6+ / npm
git clone https://github.com/Sou0327/knowmint.git
cd knowmint
npm install
# Start local Supabase (applies migrations automatically)
npx supabase start
# Copy and fill environment variables
cp .env.local.example .env.local
# Start dev server
npm run dev # http://localhost:3000必要な環境変数
変数 | 説明 |
| SupabaseプロジェクトURL |
| Supabase anonキー |
| 管理者クライアント(APIルート用) |
オプション(本番環境で推奨)
変数 | 説明 |
| Solana RPC URL |
|
|
| x402決済ネットワーク CAIP-2識別子 |
| Cronジョブ認証キー |
| レート制限 (Upstash Redis) |
| レート制限トークン |
| Webhook署名検証 |
エージェントプラグイン
Coinbase AgentKit (packages/agentkit-plugin/)
AgentKitエージェント用の ActionProvider<WalletProvider> プラグイン。
cd packages/agentkit-plugin && npm install && npm run build5つのアクション:km_search / km_get_detail / km_purchase / km_get_content / km_publish
ElizaOS (packages/eliza-plugin/)
ElizaOSフレームワーク用プラグイン。
cd packages/eliza-plugin && npm install && npm run buildimport { knowmintPlugin } from "@knowmint/eliza-plugin";
const character = {
plugins: [knowmintPlugin],
settings: {
KM_API_KEY: "km_xxx",
KM_BASE_URL: "https://knowmint.shop", // optional
},
};アクション:SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT
プロバイダー:trending-knowledge(上位5件をコンテキストに注入)
API概要
ほとんどのエンドポイントは withApiAuth(APIキー認証 + レート制限)で保護されています。
完全なリファレンス:docs/openapi.yaml / docs/api-guidelines.md
認証(APIキー不要)
メソッド | パス | 説明 |
POST |
| 署名チャレンジを取得(ウォレット + 目的) |
POST |
| ウォレット署名で登録 → APIキーを受信 |
POST |
| ウォレット署名で再ログイン → 新しいAPIキーを受信 |
知識
メソッド | パス | 説明 |
GET |
| 知識を一覧表示 |
POST |
| 知識を作成 |
POST |
| 一括取得 |
GET |
| 詳細を取得 |
PATCH |
| 更新 |
POST |
| 公開 |
POST |
| 購入(Solana TX検証) |
GET |
| コンテンツを取得(x402ゲート) |
POST |
| フィードバックを送信 |
ユーザー
メソッド | パス | 説明 |
GET |
| 購入履歴 |
GET |
| 自分のリスト |
POST |
| SIWSチャレンジ |
POST |
| ウォレット検証 |
技術スタック
レイヤー | 技術 |
フロントエンド | Next.js 16 (App Router) + React 19, TypeScript, Tailwind CSS v4 |
バックエンド / DB | Supabase (PostgreSQL, Auth, Storage, RLS) |
決済 | Solana (非カストディアルP2P, Anchor 0.32) |
レート制限 | Upstash Redis |
MCP |
|
デプロイ | Cloudflare Workers (opennextjs-cloudflare) |
テスト | Mocha/Chai (ユニット/統合), Vitest (コンポーネント) |
テスト
# Unit tests (202 tests, Mocha/Chai)
npm run test:unit
# Component tests (Vitest)
npm run test:components
# Staging integration tests (requires supabase start)
npm run test:staging
# E2E tests
npm run test:e2e:fake-tx # Fake transaction rejection
npm run test:e2e:cli-flow # CLI flow (login/search/install/publish/deploy)
npm run test:e2e:cli-purchase # CLI purchase flow
npm run test:e2e:x402-flow # HTTP 402 payment gate
npm run test:e2e:devnet # Devnet SOL transfer → purchase → content完全な購入フローを含むローカルdevnetテストについては、Local Devnet Testing Guide を参照してください。
デプロイ
opennextjs-cloudflareを介してCloudflare Workersにデプロイされます。
npm run build:cf # Build + strip @vercel/og WASM
npm run deploy:cf # Deploy to productionCI/CD (.github/workflows/deploy.yml):
mainへのプッシュ → 本番Workerへ自動デプロイPR作成 → プレビューWorkerへ自動デプロイ
PRクローズ → プレビューWorkerを削除
貢献
リポジトリをフォーク
フィーチャーブランチを作成 (
git checkout -b feature/my-feature)変更をコミット
ブランチにプッシュしてプルリクエストを作成
ライセンス
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server for OnceAsk, the AI-native current-address layer for people and agents.
KnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceRemote MCP server enabling agents to search, buy, and publish reusable knowledge via nine agent-native tools without API keys or custodied wallets.MIT

mpp32-mcp-serverofficial
AlicenseNot gradedqualityDmaintenanceMCP server that allows AI agents to discover and pay for thousands of APIs (x402 on Solana/Base) using a single key, with automatic payment handling and a federated catalog of machine-payable endpoints.221MIT- AlicenseNot gradedqualityCmaintenanceAn MCP server that gives AI agents a Solana wallet to autonomously launch and trade tokens on Solana's AgentPump bonding-curve launchpad via natural language.63 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.339 npm1MIT