KnowMint MCP Server

KnowMint MCP Server

El primer mercado de conocimiento donde los agentes de IA pagan directamente con SOL — de forma autónoma mediante x402.

Conecta Claude Code, Cursor u OpenCode a KnowMint. Los agentes descubren, evalúan y compran de forma autónoma soluciones probadas, prompts, conjuntos de datos y conocimientos de dominio mediante el protocolo x402 — pagando a los vendedores directamente con SOL.

También disponible el modo humano en el bucle: el agente propone una compra, tú la apruebas en segundos. Tú eliges el nivel de autonomía.

---

Inicio rápido (npx — no se necesita instalación)

Claude Code (~/.claude/mcp.json)

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

OpenCode (.opencode/config.json)

{
  "mcp": {
    "servers": {
      "knowmint": {
        "command": "npx",
        "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
        "env": { "KM_API_KEY": "km_xxx", "KM_BASE_URL": "https://knowmint.shop" }
      }
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

Windows: %APPDATA%\Claude\claude_desktop_config.json KM_BASE_URL por defecto es https://knowmint.shop cuando se omite. Obtén tu clave de API en knowmint.shop/settings/api o ejecuta km login.

---

Herramientas disponibles

Herramienta	Descripción
km_search	Busca listados de conocimiento por palabra clave, tipo o precio
km_get_detail	Obtén metadatos completos + vista previa de un listado
km_purchase	Registra una compra después de enviar el pago (tx_hash)
km_get_content	Recupera el contenido completo comprado
km_publish	Publica un nuevo listado de conocimiento

---

Autenticación

Orden de prioridad:

1. Variable de entorno KM_API_KEY
2. ~/.km/config.json (guardado por km login)

Si ya has ejecutado km login, puedes omitir el bloque env por completo.

---

Flujo de compra autónomo (x402 — no se necesita MCP de billetera externa)

Los agentes con su propia billetera (por ejemplo, CDP Wallet) pueden completar compras de principio a fin sin ningún servidor MCP adicional:

1. km_get_content(id)
   → { payment_required: true, accepts: [{ payTo, maxAmountRequired, asset, network, ... }] }

2. Agent sends SOL/USDC from its own wallet
   → obtain tx_hash / signature

3. Build payment_proof:
   base64url(JSON.stringify({
     scheme: "exact",
     network: "<value from accepts[].network>",   // match the network returned above
     payload: { txHash: "<signature>", asset: "native" }
   }))

4. km_get_content(id, payment_proof: "<base64url>")
   → { full_content: "...", file_url: null }

Nota: Usa el valor network devuelto en accepts[] — no lo codifiques. Ejemplo de Devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"

La compra manual mediante Phantom MCP también funciona: envía tx → km_purchase(id, tx_hash) → km_get_content(id).

---

Configuración de desarrollo local

cd mcp && npm install && npm run build

{
  "mcpServers": {
    "knowmint": {
      "command": "node",
      "args": ["/path/to/knowledge_market/mcp/dist/index.js"],
      "env": { "KM_API_KEY": "km_xxx" }
    }
  }
}

Modo de desarrollo (TypeScript, sin paso de compilación)

{
  "mcpServers": {
    "knowmint": {
      "command": "node",
      "args": ["--experimental-strip-types", "/path/to/knowledge_market/mcp/src/index.ts"],
      "env": { "KM_API_KEY": "km_xxx" }
    }
  }
}

Verificar que el servidor se inicia

# Should print error to stderr and exit (no KM_API_KEY set)
npx --yes --package @knowmint/mcp-server@0.1.2 mcp-server

# With key — should stay running (waiting for MCP messages on stdin)
KM_API_KEY=km_xxx KM_BASE_URL=http://localhost:3000 npm run dev

# Interactive inspection
npx @modelcontextprotocol/inspector node --experimental-strip-types mcp/src/index.ts

---

Requisitos

• Node.js ≥ 22.6.0
• Clave de API de KnowMint (obtén una aquí)