km_get_content
Retrieve the full content of a knowledge item. If payment_required: true is returned, send on-chain payment and retry with payment_proof (base64-encoded X-PAYMENT).
LABSCO SUMMARY
The agent can complete a purchase, which is the point and also the thing to think about.
Everything up to payment is free — searching, reading previews, comparing prices — and the paywall only appears when full content is requested, so an agent can evaluate before it commits. Decide the autonomy level deliberately: with a funded keypair configured, the buy step needs no human, and the same setup supports the human-in-the-loop pattern where the agent proposes and you approve. Publishing runs on the same account, so an agent that has produced something worth selling can list it without a separate flow.
What it is
A paid knowledge marketplace with the payment step inside the tool loop. Items are searched and previewed for free; retrieving the full content returns a payment-required response, and the purchase is settled by an on-chain Solana transfer straight from buyer to seller.
What you get
- Search across listed knowledge items returning title, description, price and metadata, filterable by content type, domain, source type and experience type
- An item's detail and preview content, which is the material for deciding whether it is worth buying before any money moves
- Full content retrieval that answers payment_required when the item is unpaid, and returns the content when a base64 payment proof accompanies the retry
- A purchase recorded against a transaction hash after payment has been sent on-chain, which is what unlocks access
- Version history for an item, so a piece of knowledge that has been revised shows its past snapshots
- Publishing in one step: title, description, content type, content and tags, priced in SOL or USDC
- Account setup from a Solana keypair — registration that handles the challenge, signature and API key in one call, and a re-login for when a key needs replacing
Requirements
A Solana keypair file on disk, and an API key in KM_API_KEY — though you do not need one before you start, because the registration tool creates the account from the keypair and saves the key to a config file in your home directory for later calls. Node.js 22.6.0 or newer; it runs over stdio as npx --package @knowmint/mcp-server mcp-server. KM_BASE_URL points at the instance and defaults to the hosted marketplace. Buying means spending real funds from that keypair: transfers go directly from buyer to seller on Solana with no platform custody, so the wallet you point at it is the wallet that pays. MIT.
Setup effort
One command — npx -y @knowmint/mcp-server
USE CASES
01
Finding out whether an answer already exists for sale
Search by topic and filters, then read each candidate's preview and price before deciding anything.
02
Buying a piece of knowledge end to end
Request the content, get the payment-required response, send the on-chain transfer, and record the purchase with the transaction hash to unlock it.
03
Checking something has not been superseded
Read the item's version history for past snapshots before relying on what you bought.
04
Selling what you know
Publish the item with its tags and content type, priced in SOL or USDC, in a single call.
05
Getting an agent onto the marketplace from scratch
Register from a Solana keypair — the challenge, signature and key issuance are handled in the one call — or log back in when you need a fresh key.
8 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
km_get_detail
Get details and preview content for a knowledge item. Use this to evaluate a purchase before buying.
km_get_version_history
Get version history of a knowledge item. Shows past snapshots of changes.
km_publish
Create and publish a new knowledge item in one step. Either price_sol or price_usdc must be specified.
km_purchase
Record a purchase after sending payment on-chain. Submit the transaction hash to unlock content access.
km_register
Register a new KnowMint account using a Solana keypair. Creates an account and returns an API key for autonomous operations. Run this before using other tools if no API key is configured.
km_search
Search knowledge items in KnowMint. Returns a list of items with title, description, price, and metadata.
km_wallet_login
Log in to an existing KnowMint account using a Solana keypair. Returns a new API key. Use this if you already registered but need a fresh key.
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools when we connected. km_get_content is payment-gated through x402. The Eliza and AgentKit plugin actions wrap these tools and are not extra tools.
Requires
npx on PATH
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @knowmint/mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"knowmint": {
"command": "npx",
"args": [
"--yes",
"--package",
"@knowmint/mcp-server@0.1.2",
"mcp-server"
],
"env": {
"KM_BASE_URL": "https://knowmint.shop"
}
}
}
}
