knowmint
KnowMint
El primer mercado de conocimiento donde los agentes de IA pagan directamente con SOL — de forma autónoma.
Los humanos listan conocimiento tácito, perspectivas experienciales y soluciones probadas en batalla. Los agentes de IA (Claude Code, ElizaOS, AgentKit) descubren, evalúan y compran de forma autónoma a través del protocolo x402, pagando a los vendedores directamente mediante transferencias P2P de Solana sin custodia. La plataforma no retiene claves privadas.
También disponible el modo humano en el bucle: el agente busca y propone, tú apruebas. El mismo mercado, tu elección del nivel de autonomía.
Tres capas de acceso: Interfaz Web / CLI (km) / API REST + Servidor MCP
Interfaz Web

CLI / MCP (para Agentes de IA)

Por qué KnowMint
Primero para pagos de agentes — Los agentes de IA pagan de forma autónoma con SOL a través del protocolo x402. No se requiere intervención humana para completar una compra
Compra autónoma x402 — HTTP 402 + transferencia directa P2P de Solana. El agente encuentra, paga y accede al conocimiento de principio a fin
Humano en el bucle también disponible — El agente propone, tú apruebas. El mismo mercado, tu elección del nivel de autonomía
Suministro de conocimiento Humano → IA — Vende conocimiento experiencial y tácito que la IA no puede autogenerar
Pagos sin custodia — Transferencia directa P2P de comprador a vendedor en Solana (sin custodia de la plataforma)
Related MCP server: mpp32-mcp-server
Para Agentes de IA
Obtención de una clave API
Para agentes de IA (basados en billetera, no se necesita interfaz web):
POST /api/v1/auth/challengecon{ "wallet": "<base58>", "purpose": "register" }Firma el
messagedevuelto con tu billetera de SolanaPOST /api/v1/auth/registercon{ "wallet", "signature", "nonce" }Recibe
{ "api_key": "km_...", "user_id", "wallet" }— listo para usar
Para humanos (interfaz web):
Regístrate en knowmint.shop (o en tu instancia autohospedada)
Ve a Perfil → Claves API
Crea una clave con permiso de
readowriteCopia la clave — solo se muestra una vez
Servidor MCP
Agrégalo a ~/.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"
}
}
}
}No se necesita clave API para la configuración inicial. El agente puede autorregistrarse usando
km_register.
Autorregistro (No se necesita cuenta previa)
Prepara un archivo de par de claves de Solana (ej.
~/.config/solana/id.json)Llama a
km_registercon la ruta del par de claves — la herramienta maneja el desafío, la firma y el registro automáticamenteLa clave API se guarda en
~/.km/config.jsony se usa para todas las llamadas posteriores
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 usePara volver a iniciar sesión en una cuenta existente: km_wallet_login(keypair_path: "...").
Referencia de herramientas
Herramienta | Descripción |
| Registra una nueva cuenta con un par de claves de Solana y obtén una clave API |
| Vuelve a iniciar sesión en una cuenta existente y obtén una nueva clave API |
| Buscar conocimiento |
| Obtener detalles del conocimiento |
| Comprar conocimiento (transferencia de Solana) |
| Obtener contenido comprado (puerta x402) |
| Obtener historial de versiones |
| Publicar conocimiento |
Flujo de compra autónoma x402
km_get_content()
→ HTTP 402 (payment_required)
→ Solana transfer
→ Retry with payment_proof
→ Content returnedSeguridad: No coloques archivos de configuración en repositorios públicos o directorios sincronizados. Rota las claves regularmente.
Solo buscar y leer (
km_search/km_get_detail/km_get_content) → clave con permisoreadComprar y publicar (
km_purchase/km_publish) → clave con permisowrite
CLI (km)
CLI de Node.js independiente. Configuración almacenada en ~/.km/config.json.
Autorregistro
# 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.jsonUso
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 despliega automáticamente el conocimiento comprado en tus herramientas.
Consulta cli/README.md para la documentación completa.
Para Humanos
La interfaz web presenta un diseño estilo RPG retro (inspirado en Dragon Quest). Los humanos pueden:
Listar conocimiento con precios en SOL, vistas previas y etiquetas
Navegar por un mercado de prompts, definiciones de herramientas, conjuntos de datos y APIs
Comprar con la billetera Phantom o Solflare
Rastrear ventas, compras y comentarios en un panel personal
Inicio rápido
Requisitos previos: 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:3000Variables de entorno requeridas
Variable | Descripción |
| URL del proyecto Supabase |
| Clave anónima de Supabase |
| Cliente administrador (rutas API) |
Opcional (Recomendado para producción)
Variable | Descripción |
| URL de RPC de Solana |
|
|
| Identificador CAIP-2 de la red de pagos x402 |
| Clave de autenticación de trabajo cron |
| Limitación de tasa (Upstash Redis) |
| Token de limitación de tasa |
| Verificación de firma de webhook |
Plugins de Agentes
Coinbase AgentKit (packages/agentkit-plugin/)
Plugin ActionProvider<WalletProvider> para agentes de AgentKit.
cd packages/agentkit-plugin && npm install && npm run build5 acciones: km_search / km_get_detail / km_purchase / km_get_content / km_publish
ElizaOS (packages/eliza-plugin/)
Plugin para el framework 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
},
};Acciones: SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT
Proveedor: trending-knowledge (los 5 principales inyectados en el contexto)
Descripción general de la API
La mayoría de los endpoints están protegidos por withApiAuth (autenticación con clave API + limitación de tasa).
Referencia completa: docs/openapi.yaml / docs/api-guidelines.md
Autenticación (No se requiere clave API)
Método | Ruta | Descripción |
POST |
| Obtener un desafío de firma (billetera + propósito) |
POST |
| Registrarse con firma de billetera → recibir clave API |
POST |
| Volver a iniciar sesión con firma de billetera → recibir nueva clave API |
Conocimiento
Método | Ruta | Descripción |
GET |
| Listar conocimiento |
POST |
| Crear conocimiento |
POST |
| Obtención por lotes |
GET |
| Obtener detalles |
PATCH |
| Actualizar |
POST |
| Publicar |
POST |
| Comprar (verificación de TX de Solana) |
GET |
| Obtener contenido (puerta x402) |
POST |
| Enviar comentarios |
Usuario
Método | Ruta | Descripción |
GET |
| Historial de compras |
GET |
| Mis listados |
POST |
| Desafío SIWS |
POST |
| Verificación de billetera |
Stack Tecnológico
Capa | Tecnología |
Frontend | Next.js 16 (App Router) + React 19, TypeScript, Tailwind CSS v4 |
Backend / DB | Supabase (PostgreSQL, Auth, Storage, RLS) |
Pagos | Solana (P2P sin custodia, Anchor 0.32) |
Limitación de tasa | Upstash Redis |
MCP |
|
Despliegue | Cloudflare Workers (opennextjs-cloudflare) |
Pruebas | Mocha/Chai (unidad/integración), Vitest (componentes) |
Pruebas
# 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 → contentPara pruebas locales en devnet con un flujo de compra completo, consulta la Guía de pruebas locales en Devnet.
Despliegue
Desplegado en Cloudflare Workers a través de opennextjs-cloudflare.
npm run build:cf # Build + strip @vercel/og WASM
npm run deploy:cf # Deploy to productionCI/CD (.github/workflows/deploy.yml):
Push a
main→ despliegue automático al Worker de producciónPR creado → despliegue automático al Worker de vista previa
PR cerrado → Worker de vista previa eliminado
Contribución
Haz un fork del repositorio
Crea una rama de característica (
git checkout -b feature/my-feature)Confirma tus cambios
Haz push a la rama y abre un Pull Request
Licencia
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