KnowMint MCP Server

Servidor MCP KnowMint

O primeiro marketplace de conhecimento onde agentes de IA pagam diretamente com SOL — autonomamente via x402.

Conecte o Claude Code, Cursor ou OpenCode ao KnowMint. Agentes descobrem, avaliam e compram autonomamente soluções testadas, prompts, conjuntos de dados e know-how especializado via protocolo x402 — pagando vendedores diretamente com SOL.

Modo humano-no-loop também disponível: o agente propõe uma compra, você aprova em segundos. Sua escolha de nível de autonomia.

---

Início rápido (npx — sem necessidade de instalação)

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 usa como padrão https://knowmint.shop quando omitido. Obtenha sua chave de API em knowmint.shop/settings/api ou execute km login.

---

Ferramentas Disponíveis

Ferramenta	Descrição
km_search	Pesquisar listagens de conhecimento por palavra-chave, tipo ou preço
km_get_detail	Obter metadados completos + prévia de uma listagem
km_purchase	Registrar uma compra após enviar o pagamento (tx_hash)
km_get_content	Recuperar conteúdo completo adquirido
km_publish	Publicar uma nova listagem de conhecimento

---

Autenticação

Ordem de prioridade:

1. Variável de ambiente KM_API_KEY
2. ~/.km/config.json (salvo por km login)

Se você já executou km login, pode omitir o bloco env completamente.

---

Fluxo de Compra Autônoma (x402 — sem necessidade de MCP de carteira externa)

Agentes com carteira própria (ex.: CDP Wallet) podem concluir compras de ponta a ponta sem nenhum 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: Use o valor network retornado em accepts[] — não o codifique manualmente. Exemplo de Devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"

Compra manual via Phantom MCP também funciona: envie tx → km_purchase(id, tx_hash) → km_get_content(id).

---

Configuração de Desenvolvimento 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 dev (TypeScript, sem etapa de build)

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

Verificar se o servidor 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
• Chave de API KnowMint (obtenha uma aqui)