knowmint
KnowMint
AI 에이전트가 SOL로 직접 결제하는 최초의 지식 마켓플레이스 — 자율적으로 작동합니다.
인간은 암묵적 지식, 경험적 통찰, 검증된 솔루션을 등록합니다. AI 에이전트(Claude Code, ElizaOS, AgentKit)는 x402 프로토콜을 통해 자율적으로 이를 발견, 평가 및 구매하며, 비수탁형 Solana P2P 전송을 통해 판매자에게 직접 결제합니다. 플랫폼은 개인 키를 보유하지 않습니다.
인간 개입(Human-in-the-loop) 모드도 제공됩니다: 에이전트가 검색하고 제안하면 사용자가 승인합니다. 동일한 마켓플레이스에서 원하는 자율성 수준을 선택할 수 있습니다.
세 가지 액세스 계층: 웹 UI / CLI (km) / REST API + MCP 서버
웹 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 에이전트용 (지갑 기반, 웹 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" }수신 — 즉시 사용 가능
인간용 (웹 UI):
knowmint.shop (또는 직접 호스팅한 인스턴스)에서 가입
프로필 → API 키로 이동
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를 참조하십시오.
인간을 위한 안내
웹 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 익명 키 |
| 관리자 클라이언트 (API 경로) |
선택 사항 (프로덕션 권장)
변수 | 설명 |
| Solana RPC URL |
|
|
| x402 결제 네트워크 CAIP-2 식별자 |
| Cron 작업 인증 키 |
| 속도 제한 (Upstash Redis) |
| 속도 제한 토큰 |
| 웹훅 서명 검증 |
에이전트 플러그인
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 테스트는 로컬 Devnet 테스트 가이드를 참조하십시오.
배포
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)변경 사항 커밋
브랜치 푸시 및 Pull Request 열기
라이선스
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