Skip to main content
Glama

KnowMint

License: MIT Deploy: Cloudflare Workers

Der erste Wissensmarktplatz, auf dem KI-Agenten direkt mit SOL bezahlen — autonom.

Menschen listen stilles Wissen, erfahrungsbasierte Erkenntnisse und praxiserprobte Lösungen. KI-Agenten (Claude Code, ElizaOS, AgentKit) entdecken, bewerten und kaufen diese autonom über das x402-Protokoll — und bezahlen Verkäufer direkt per nicht-verwahrter (non-custodial) Solana P2P-Überweisung. Die Plattform hält keine privaten Schlüssel.

Ein „Human-in-the-loop“-Modus ist ebenfalls verfügbar: Der Agent sucht und schlägt vor, Sie genehmigen. Derselbe Marktplatz, Sie wählen den Grad der Autonomie.

Drei Zugriffsebenen: Web-UI / CLI (km) / REST-API + MCP-Server

Web-UI

WebUI Purchase Flow

CLI / MCP (für KI-Agenten)

AI Agent Autonomous Purchase Demo


Warum KnowMint

  • Vorreiter bei Agenten-Zahlungen — KI-Agenten bezahlen autonom mit SOL über das x402-Protokoll. Kein Mensch erforderlich, um einen Kauf abzuschließen

  • x402 autonomes Einkaufen — HTTP 402 + Solana P2P-Direktüberweisung. Der Agent findet, bezahlt und greift durchgängig auf das Wissen zu

  • Human-in-the-loop ebenfalls verfügbar — Der Agent schlägt vor, Sie genehmigen. Derselbe Marktplatz, Sie wählen den Grad der Autonomie

  • Mensch → KI Wissensangebot — Verkaufen Sie erfahrungsbasiertes und stilles Wissen, das eine KI nicht selbst generieren kann

  • Nicht-verwahrte Zahlungen — P2P-Direktüberweisung vom Käufer zum Verkäufer auf Solana (keine Verwahrung durch die Plattform)


Related MCP server: mpp32-mcp-server

Für KI-Agenten

Einen API-Schlüssel erhalten

Für KI-Agenten (wallet-basiert, keine Web-UI erforderlich):

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

  2. Signieren Sie die zurückgegebene message mit Ihrer Solana-Wallet

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

  4. Erhalten Sie { "api_key": "km_...", "user_id", "wallet" } — bereit zur Verwendung

Für Menschen (Web-UI):

  1. Registrieren Sie sich unter knowmint.shop (oder Ihrer selbst gehosteten Instanz)

  2. Gehen Sie zu Profile → API Keys

  3. Erstellen Sie einen Schlüssel mit read- oder write-Berechtigung

  4. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt

MCP-Server

Fügen Sie dies zu ~/.claude/mcp.json hinzu:

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

Für die Ersteinrichtung ist kein API-Schlüssel erforderlich. Der Agent kann sich selbst über km_register registrieren.

Selbstregistrierung (Kein vorheriges Konto erforderlich)

  1. Bereiten Sie eine Solana-Keypair-Datei vor (z. B. ~/.config/solana/id.json)

  2. Rufen Sie km_register mit dem Pfad zum Keypair auf — das Tool übernimmt Challenge, Signatur und Registrierung automatisch

  3. Der API-Schlüssel wird unter ~/.km/config.json gespeichert und für alle nachfolgenden Aufrufe verwendet

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

Um sich erneut bei einem bestehenden Konto anzumelden: km_wallet_login(keypair_path: "...").

Tool-Referenz

Tool

Beschreibung

km_register

Registrieren Sie ein neues Konto mit einem Solana-Keypair und erhalten Sie einen API-Schlüssel

km_wallet_login

Melden Sie sich erneut bei einem bestehenden Konto an und erhalten Sie einen neuen API-Schlüssel

km_search

Wissen suchen

km_get_detail

Wissensdetails abrufen

km_purchase

Wissen kaufen (Solana-Überweisung)

km_get_content

Gekaufte Inhalte abrufen (x402-Sperre)

km_get_version_history

Versionsverlauf abrufen

km_publish

Wissen veröffentlichen

x402 Autonomer Kaufprozess

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

Sicherheit: Speichern Sie Konfigurationsdateien nicht in öffentlichen Repositories oder synchronisierten Verzeichnissen. Rotieren Sie Schlüssel regelmäßig.

  • Nur Suchen & Lesen (km_search / km_get_detail / km_get_content) → read-Berechtigungsschlüssel

  • Kaufen & Veröffentlichen (km_purchase / km_publish) → write-Berechtigungsschlüssel

CLI (km)

Eigenständige Node.js CLI. Konfiguration gespeichert in ~/.km/config.json.

Selbstregistrierung

# 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

Verwendung

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 stellt gekauftes Wissen automatisch für Ihre Tools bereit.

Siehe cli/README.md für die vollständige Dokumentation.


Für Menschen

Die Web-UI bietet ein Retro-RPG-Design (inspiriert von Dragon Quest). Menschen können:

  • Wissen listen mit SOL-Preisen, Vorschauen und Tags

  • Einen Marktplatz für Prompts, Tool-Definitionen, Datensätze und APIs durchsuchen

  • Kaufen mit Phantom- oder Solflare-Wallet

  • Verkäufe, Käufe und Feedback auf einem persönlichen Dashboard verfolgen


Schnellstart

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

Erforderliche Umgebungsvariablen

Variable

Beschreibung

NEXT_PUBLIC_SUPABASE_URL

Supabase-Projekt-URL

NEXT_PUBLIC_SUPABASE_ANON_KEY

Supabase-Anon-Schlüssel

SUPABASE_SERVICE_ROLE_KEY

Admin-Client (API-Routen)

Optional (Empfohlen für Produktion)

Variable

Beschreibung

NEXT_PUBLIC_SOLANA_RPC_URL

Solana-RPC-URL

NEXT_PUBLIC_SOLANA_NETWORK

devnet (Standard) / mainnet-beta

X402_NETWORK

x402 Zahlungsnetzwerk CAIP-2 Identifikator

CRON_SECRET

Cron-Job-Authentifizierungsschlüssel

UPSTASH_REDIS_REST_URL

Ratenbegrenzung (Upstash Redis)

UPSTASH_REDIS_REST_TOKEN

Ratenbegrenzungs-Token

WEBHOOK_SIGNING_KEY

Webhook-Signaturverifizierung


Agenten-Plugins

Coinbase AgentKit (packages/agentkit-plugin/)

ActionProvider<WalletProvider>-Plugin für AgentKit-Agenten.

cd packages/agentkit-plugin && npm install && npm run build

5 Aktionen: km_search / km_get_detail / km_purchase / km_get_content / km_publish

ElizaOS (packages/eliza-plugin/)

Plugin für das ElizaOS-Framework.

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
  },
};

Aktionen: SEARCH_KNOWLEDGE / PURCHASE_KNOWLEDGE / GET_CONTENT Provider: trending-knowledge (Top 5 in den Kontext injiziert)


API-Übersicht

Die meisten Endpunkte sind durch withApiAuth geschützt (API-Schlüssel-Authentifizierung + Ratenbegrenzung). Vollständige Referenz: docs/openapi.yaml / docs/api-guidelines.md

Auth (Kein API-Schlüssel erforderlich)

Methode

Pfad

Beschreibung

POST

/api/v1/auth/challenge

Erhalten Sie eine Signatur-Challenge (Wallet + Zweck)

POST

/api/v1/auth/register

Registrieren mit Wallet-Signatur → API-Schlüssel erhalten

POST

/api/v1/auth/login

Erneute Anmeldung mit Wallet-Signatur → neuen API-Schlüssel erhalten

Wissen

Methode

Pfad

Beschreibung

GET

/api/v1/knowledge

Wissen auflisten

POST

/api/v1/knowledge

Wissen erstellen

POST

/api/v1/knowledge/batch

Batch-Abruf

GET

/api/v1/knowledge/{id}

Details abrufen

PATCH

/api/v1/knowledge/{id}

Aktualisieren

POST

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

Veröffentlichen

POST

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

Kaufen (Solana TX-Verifizierung)

GET

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

Inhalt abrufen (x402-Sperre)

POST

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

Feedback einreichen

Benutzer

Methode

Pfad

Beschreibung

GET

/api/v1/me/purchases

Kaufhistorie

GET

/api/v1/me/listings

Meine Einträge

POST

/api/v1/me/wallet/challenge

SIWS-Challenge

POST

/api/v1/me/wallet/verify

Wallet-Verifizierung


Tech-Stack

Ebene

Technologie

Frontend

Next.js 16 (App Router) + React 19, TypeScript, Tailwind CSS v4

Backend / DB

Supabase (PostgreSQL, Auth, Storage, RLS)

Zahlungen

Solana (nicht-verwahrtes P2P, Anchor 0.32)

Ratenbegrenzung

Upstash Redis

MCP

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

Deployment

Cloudflare Workers (opennextjs-cloudflare)

Tests

Mocha/Chai (Unit/Integration), Vitest (Komponenten)


Testen

# 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

Für lokale Devnet-Tests mit einem vollständigen Kaufprozess, siehe Local Devnet Testing Guide.


Deployment

Bereitstellung auf Cloudflare Workers via 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 auf main → automatische Bereitstellung auf dem Produktions-Worker

  • PR erstellt → automatische Bereitstellung auf dem Preview-Worker

  • PR geschlossen → Preview-Worker gelöscht


Mitwirken

  1. Forken Sie das Repository

  2. Erstellen Sie einen Feature-Branch (git checkout -b feature/my-feature)

  3. Committen Sie Ihre Änderungen

  4. Pushen Sie auf den Branch und öffnen Sie einen Pull Request


Lizenz

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