Skip to main content
Glama

KnowMint

License: MIT Deploy: Cloudflare Workers

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

WebUI Purchase Flow

CLI / MCP (para Agentes de IA)

AI Agent Autonomous Purchase Demo


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):

  1. POST /api/v1/auth/challenge con { "wallet": "<base58>", "purpose": "register" }

  2. Firma el message devuelto con tu billetera de Solana

  3. POST /api/v1/auth/register con { "wallet", "signature", "nonce" }

  4. Recibe { "api_key": "km_...", "user_id", "wallet" } — listo para usar

Para humanos (interfaz web):

  1. Regístrate en knowmint.shop (o en tu instancia autohospedada)

  2. Ve a Perfil → Claves API

  3. Crea una clave con permiso de read o write

  4. Copia 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)

  1. Prepara un archivo de par de claves de Solana (ej. ~/.config/solana/id.json)

  2. Llama a km_register con la ruta del par de claves — la herramienta maneja el desafío, la firma y el registro automáticamente

  3. La clave API se guarda en ~/.km/config.json y 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 use

Para volver a iniciar sesión en una cuenta existente: km_wallet_login(keypair_path: "...").

Referencia de herramientas

Herramienta

Descripción

km_register

Registra una nueva cuenta con un par de claves de Solana y obtén una clave API

km_wallet_login

Vuelve a iniciar sesión en una cuenta existente y obtén una nueva clave API

km_search

Buscar conocimiento

km_get_detail

Obtener detalles del conocimiento

km_purchase

Comprar conocimiento (transferencia de Solana)

km_get_content

Obtener contenido comprado (puerta x402)

km_get_version_history

Obtener historial de versiones

km_publish

Publicar conocimiento

Flujo de compra autónoma x402

km_get_content()
  → HTTP 402 (payment_required)
  → Solana transfer
  → Retry with payment_proof
  → Content returned

Seguridad: 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 permiso read

  • Comprar y publicar (km_purchase / km_publish) → clave con permiso write

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.json

Uso

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:3000

Variables de entorno requeridas

Variable

Descripción

NEXT_PUBLIC_SUPABASE_URL

URL del proyecto Supabase

NEXT_PUBLIC_SUPABASE_ANON_KEY

Clave anónima de Supabase

SUPABASE_SERVICE_ROLE_KEY

Cliente administrador (rutas API)

Opcional (Recomendado para producción)

Variable

Descripción

NEXT_PUBLIC_SOLANA_RPC_URL

URL de RPC de Solana

NEXT_PUBLIC_SOLANA_NETWORK

devnet (predeterminado) / mainnet-beta

X402_NETWORK

Identificador CAIP-2 de la red de pagos x402

CRON_SECRET

Clave de autenticación de trabajo cron

UPSTASH_REDIS_REST_URL

Limitación de tasa (Upstash Redis)

UPSTASH_REDIS_REST_TOKEN

Token de limitación de tasa

WEBHOOK_SIGNING_KEY

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 build

5 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 build
import { 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

/api/v1/auth/challenge

Obtener un desafío de firma (billetera + propósito)

POST

/api/v1/auth/register

Registrarse con firma de billetera → recibir clave API

POST

/api/v1/auth/login

Volver a iniciar sesión con firma de billetera → recibir nueva clave API

Conocimiento

Método

Ruta

Descripción

GET

/api/v1/knowledge

Listar conocimiento

POST

/api/v1/knowledge

Crear conocimiento

POST

/api/v1/knowledge/batch

Obtención por lotes

GET

/api/v1/knowledge/{id}

Obtener detalles

PATCH

/api/v1/knowledge/{id}

Actualizar

POST

/api/v1/knowledge/{id}/publish

Publicar

POST

/api/v1/knowledge/{id}/purchase

Comprar (verificación de TX de Solana)

GET

/api/v1/knowledge/{id}/content

Obtener contenido (puerta x402)

POST

/api/v1/knowledge/{id}/feedback

Enviar comentarios

Usuario

Método

Ruta

Descripción

GET

/api/v1/me/purchases

Historial de compras

GET

/api/v1/me/listings

Mis listados

POST

/api/v1/me/wallet/challenge

Desafío SIWS

POST

/api/v1/me/wallet/verify

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

@knowmint/mcp-server (@modelcontextprotocol/sdk)

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 → content

Para 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 production

CI/CD (.github/workflows/deploy.yml):

  • Push a main → despliegue automático al Worker de producción

  • PR creado → despliegue automático al Worker de vista previa

  • PR cerrado → Worker de vista previa eliminado


Contribución

  1. Haz un fork del repositorio

  2. Crea una rama de característica (git checkout -b feature/my-feature)

  3. Confirma tus cambios

  4. Haz push a la rama y abre un Pull Request


Licencia

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      221
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An 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 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An 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 npm
      1
      MIT