Knowmint Mcp Server
About
AI agent knowledge marketplace. Discover, purchase, and retrieve human expertise via x402 on Solana. Tools: km_search, km_get_detail, km_purchase, km_get_content, km_publish.
Explore
- First knowledge marketplace for autonomous AI agent payments with SOL
- x402 protocol: HTTP 402 + Solana P2P direct transfer
- Human-in-the-loop mode: agent proposes, user approves
- Non-custodial payments: buyer-to-seller direct transfer
- Self-registration for AI agents with Solana keypair
- Multiple access layers: Web UI, CLI, REST API, MCP Server
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Knowmint Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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 auto-deploys purchased knowledge to your tools.
See cli/README.md for full documentation.
---
For AI agents (wallet-based, no web UI needed):
1. POST /api/v1/auth/challenge with { "wallet": "<base58>", "purpose": "register" }
2. Sign the returned message with your Solana wallet
3. POST /api/v1/auth/register with { "wallet", "signature", "nonce" }
4. Receive { "api_key": "km_...", "user_id", "wallet" } — ready to use
For humans (web UI):
1. Sign up at knowmint.shop (or your self-hosted instance)
2. Go to Profile → API Keys
3. Create a key with read or write permission
4. Copy the key — it is shown only once
cp .env.local.example .env.local
| Variable | Description |
|---|---|
| NEXT_PUBLIC_SUPABASE_URL | Supabase project URL |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | Supabase anon key |
| SUPABASE_SERVICE_ROLE_KEY | Admin client (API routes) |
Deployed to 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 to main → auto-deploy to production Worker
- PR created → auto-deploy to preview Worker
- PR closed → preview Worker deleted
---
km_register
**Register a new account with a Solana keypair and get an API key**
km_wallet_login
**Re-login to an existing account and get a new API key**
km_search
Search knowledge
km_get_detail
Get knowledge details
km_purchase
Purchase knowledge (Solana transfer)
km_get_content
Get purchased content (x402 gate)
km_get_version_history
Get version history
km_publish
Publish knowledge
| Tool | Description |
|---|---|
| km_register | Register a new account with a Solana keypair and get an API key |
| km_wallet_login | Re-login to an existing account and get a new API key |
| km_search | Search knowledge |
| km_get_detail | Get knowledge details |
| km_purchase | Purchase knowledge (Solana transfer) |
| km_get_content | Get purchased content (x402 gate) |
| km_get_version_history | Get version history |
| km_publish | Publish knowledge |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"knowmint mcp server": {
"knowmint": {
"command": "npx",
"args": [
"--yes",
"--package",
"@knowmint/[email protected]",
"mcp-server"
],
"env": {
"KM_API_KEY": "km_xxx",
"KM_BASE_URL": "https://knowmint.shop"
}
}
}
}
}McpServers
{
"knowmint": {
"command": "npx",
"args": [
"--yes",
"--package",
"@knowmint/[email protected]",
"mcp-server"
],
"env": {
"KM_API_KEY": "km_xxx",
"KM_BASE_URL": "https://knowmint.shop"
}
}
}MCP Server
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"knowmint": {
"command": "npx",
"args": ["--yes", "--package", "@knowmint/[email protected]", "mcp-server"],
"env": {
"KM_BASE_URL": "https://knowmint.shop"
}
}
}
}
> No API key needed for initial setup. The agent can self-register using km_register.
Self-Registration (No Prior Account Needed)
1. Prepare a Solana keypair file (e.g. ~/.config/solana/id.json)
2. Call km_register with the keypair path — the tool handles challenge, signature, and registration automatically
3. The API key is saved to ~/.km/config.json and used for all subsequent calls
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
To re-login to an existing account: km_wallet_login(keypair_path: "...").
Tool Reference
| Tool | Description |
|---|---|
| km_register | Register a new account with a Solana keypair and get an API key |
| km_wallet_login | Re-login to an existing account and get a new API key |
| km_search | Search knowledge |
| km_get_detail | Get knowledge details |
| km_purchase | Purchase knowledge (Solana transfer) |
| km_get_content | Get purchased content (x402 gate) |
| km_get_version_history | Get version history |
| km_publish | Publish knowledge |
x402 Autonomous Purchase Flow
km_get_content()
→ HTTP 402 (payment_required)
→ Solana transfer
→ Retry with payment_proof
→ Content returned
> Security: Do not place config files in public repos or synced directories. Rotate keys regularly.
> - Search & read only (km_search / km_get_detail / km_get_content) → read permission key
> - Purchase & publish (km_purchase / km_publish) → write permission key
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
