Knowmint Mcp Server

by Sou0327

300 downloads
Not rated
GitHub

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.

Details

Author
Sou0327
Downloads
300
Categories
Other, AI, Knowledge Base

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

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Knowmint Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add it to ~/.claude/mcp.json with command npx --yes --package @knowmint/mcp-server@0.1.2 mcp-server and environment variable KM_BASE_URL. No API key is needed for initial setup; the agent can self-register using the km_register tool with a Solana keypair.

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/mcp-server@0.1.2",
                    "mcp-server"
                ],
                "env": {
                    "KM_API_KEY": "km_xxx",
                    "KM_BASE_URL": "https://knowmint.shop"
                }
            }
        }
    }
}

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

MCP Server

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/mcp-server@0.1.2", "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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.