Frequently Asked Questions
What is x402?
x402 is an open protocol by Coinbase that enables machine-to-machine payments via HTTP 402 status codes. When an AI agent requests paid content, the server responds with HTTP 402 and payment instructions. The agent then sends cryptocurrency (SOL on Solana) directly and resubmits the request with a payment proof. No human intervention required.
How do AI agents purchase knowledge on KnowMint?
AI agents use the MCP (Model Context Protocol) server to interact with KnowMint. The agent calls km_search to discover knowledge, km_get_detail to evaluate it, and km_get_content to purchase. When payment is required, the server returns HTTP 402 with the seller's wallet address and price. The agent sends SOL directly from its wallet and includes the transaction hash as payment proof.
What payment methods are supported?
KnowMint currently supports SOL payments on the Solana blockchain. Payments are direct wallet-to-wallet transfers — we never hold your funds or private keys. Support for additional tokens (USDC) and EVM chains is planned.
How do I set up the MCP server for Claude Code or Cursor?
Add the following to your ~/.claude/mcp.json (Claude Code) or .cursor/mcp.json (Cursor): set the command to 'npx', args to ['--yes', '--package', '@knowmint/mcp-server@latest', 'mcp-server'], and add KM_API_KEY and KM_BASE_URL (https://knowmint.shop) as environment variables. Get your API key from Dashboard > API Keys.
Is my wallet secure?
Yes. KnowMint is fully non-custodial — we never store or have access to your private keys. All payments are direct peer-to-peer transfers from the buyer's wallet to the seller's wallet. We only verify and record transaction hashes on the Solana blockchain.
What types of knowledge can I sell?
You can sell prompts, tool definitions and MCP configurations, datasets, API specifications, and general knowledge. Content is text-based and can include Markdown formatting. Each listing includes a preview (visible before purchase) and full content (accessible after purchase).
How do refunds work?
Due to the nature of digital content, refunds are generally not available once content has been disclosed. However, if the content materially differs from the description, a technical issue prevents access, or the seller provided false descriptions, we will work with the seller to find an appropriate resolution. Please review listings carefully before purchasing.
What are Solana gas fees and how much do they cost?
Solana gas fees are network transaction fees required to process blockchain transactions. On Solana, these fees are extremely low — typically less than $0.01 per transaction. The fee is paid by the buyer's wallet automatically when sending SOL to the seller. No additional platform fees are charged by KnowMint.
My purchase didn't go through. What should I do?
First, check your wallet for the transaction status. If the transaction was confirmed on-chain but content wasn't delivered, try refreshing the page or accessing the content again from your Library. If the issue persists, report it on our GitHub Issues page with your transaction hash — we can verify the on-chain transaction and resolve access issues.
How is my data handled on KnowMint?
We collect only what's necessary: email for authentication, wallet address for payments, and transaction hashes for verification. API keys are stored as SHA-256 hashes (plaintext is never stored). We don't share data with third-party advertising networks. All data is protected by Row Level Security (RLS) in our database. See our Privacy Policy for full details.
Which AI agents are supported?
KnowMint supports any AI agent that can make HTTP requests. We provide official integrations for: MCP Server (Claude Code, Cursor, and any MCP-compatible client), ElizaOS Plugin (@knowledge-market/eliza-plugin), and Coinbase AgentKit ActionProvider (@knowledge-market/agentkit-plugin). You can also integrate via the REST API or CLI (km) tool.
How does KnowMint protect against fraud?
Multiple layers: all transactions are verified on the Solana blockchain, API keys use SHA-256 hashing, rate limiting prevents abuse (120 req/min pre-auth, 60 req/min per key), content reports are reviewed by administrators, and SECURITY DEFINER functions with restricted search paths protect database operations. The platform is also fully non-custodial — we never hold funds.
What is KnowMint?
KnowMint is the first AI-native knowledge marketplace where AI agents autonomously discover and purchase human expertise using the x402 protocol on Solana. Humans list their tacit knowledge, experiential insights, and specialized expertise. AI agents find and buy this knowledge — paying SOL directly from their wallets to sellers' wallets with no intermediary.
How do I list knowledge on KnowMint?
Sign in, click 'List Item' in the navigation, fill in title, description, category, and price (in SOL), then add preview content (visible before purchase) and full content (accessible after purchase). You can save as draft or publish immediately. Content supports Markdown formatting.
Does KnowMint charge platform fees?
No. KnowMint currently charges zero platform commission. The full payment goes directly from the buyer's wallet to the seller's wallet. The only additional cost is the Solana network transaction fee (gas), which is typically less than $0.01.
How do I use the CLI tool?
Install with 'npm run km -- <command>' or use npx. Available commands include: 'km search' to find knowledge, 'km install <id>' to purchase and download, 'km publish prompt <file> --price 0.1SOL' to list knowledge, and 'km my purchases' to view your purchases. Configure your API key in ~/.km/config.json.
Which blockchain does KnowMint use?
KnowMint uses the Solana blockchain for all payments. Solana was chosen for its low transaction fees (typically < $0.01), fast confirmation times, and dominant position in AI agent transactions (77% of AI agent TX on Solana). Payments are made in SOL, the native token of Solana.
Is KnowMint open source?
Yes. KnowMint is fully open source under the MIT License. The entire codebase — including the marketplace, MCP server, CLI, ElizaOS plugin, and AgentKit plugin — is available on GitHub at github.com/Sou0327/knowmint. Contributions are welcome.
How do I get an API key?
Sign in to KnowMint, go to Dashboard > API Keys, and click 'Create new API key'. Choose a name, select permissions (read, write, or admin), and create. The key is shown only once — copy it immediately. API keys are stored as SHA-256 hashes; we cannot retrieve your key later.