Knowmint

io.github.Sou0327Published by GitHub account Sou0327v0.1.4Updated Oct 24, 2026

AI agent knowledge marketplace. Discover, purchase, and retrieve human expertise via x402 on Solana.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search, buy, and retrieve paid human knowledge listings, paying sellers in SOL via the x402 protocol.

What you can do
KnowMint is a marketplace MCP server exposing tools to search knowledge listings by keyword, type, or price (km_search), read full metadata and previews (km_get_detail), record a purchase after payment (km_purchase), retrieve purchased content (km_get_content), and publish new listings (km_publish). Purchases can be completed autonomously by an agent with its own wallet using the x402 flow, or in a human-in-the-loop mode where the agent proposes and the user approves.
When to use it
Worth adding when an assistant should find and acquire third-party prompts, datasets, or domain know-how from a marketplace, and when you are willing to let it spend SOL or USDC on those purchases, either autonomously or with approval.
Requirements
Runs locally over stdio via the npm package @knowmint/mcp-server, so Node.js 22.6.0 or newer is needed. A KnowMint API key is required, supplied through the KM_API_KEY environment variable or a config file saved by km login. KM_BASE_URL is optional and defaults to the KnowMint site. Network access to the marketplace is required.
Before you install
Purchases spend real SOL or USDC from a wallet, and autonomous mode lets the agent pay without asking each time. The KM_API_KEY secret is passed in the environment, and the server records purchases and can publish listings, which writes data to the marketplace. Payment proofs and transaction hashes are sent to the KnowMint service.

Installation

In SourceWeft

  1. Open Knowmint in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

KnowMint MCP Server

The first knowledge marketplace where AI agents pay directly with SOL — autonomously via x402.

Connect Claude Code, Cursor, or OpenCode to KnowMint. Agents autonomously discover, evaluate, and purchase battle-tested solutions, prompts, datasets, and domain know-how via the x402 protocol — paying sellers directly with SOL.

Human-in-the-loop mode also available: agent proposes a purchase, you approve in seconds. Your choice of autonomy level.

Quickstart (npx — no install needed)

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

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

Cursor (~/.cursor/mcp.json)

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

OpenCode (.opencode/config.json)

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

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

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

Windows: %APPDATA%\Claude\claude_desktop_config.json KM_BASE_URL defaults to https://knowmint.shop when omitted. Get your API key at knowmint.shop/settings/api or run km login.

Available Tools

ToolDescription
km_searchSearch knowledge listings by keyword, type, or price
km_get_detailGet full metadata + preview for a listing
km_purchaseRecord a purchase after sending payment (tx_hash)
km_get_contentRetrieve purchased full content
km_publishPublish a new knowledge listing

Authentication

Priority order:

  1. KM_API_KEY environment variable
  2. ~/.km/config.json (saved by km login)

If you've already run km login, you can omit the env block entirely.

Autonomous Purchase Flow (x402 — no external wallet MCP needed)

Agents with their own wallet (e.g. CDP Wallet) can complete purchases end-to-end without any additional MCP server:

text
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 }

Note: Use the network value returned in accepts[] — do not hardcode it. Devnet example: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"

Manual purchase via Phantom MCP also works: send tx → km_purchase(id, tx_hash) → km_get_content(id).

Local Development Setup

bash
cd mcp && npm install && npm run build
json
{  "mcpServers": {    "knowmint": {      "command": "node",      "args": ["/path/to/knowledge_market/mcp/dist/index.js"],      "env": { "KM_API_KEY": "km_xxx" }    }  }}

Dev mode (TypeScript, no build step)

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

Verify the server starts

bash
# Should print error to stderr and exit (no KM_API_KEY set)npx --yes --package @knowmint/[email protected] 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 inspectionnpx @modelcontextprotocol/inspector node --experimental-strip-types mcp/src/index.ts

Requirements

Source: mcp/README.md at commit 0d45fa9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts