K402 MCP Server

by kali123411 Your server? Claim it

answering

K402 is answering right now. Last checked 2 min ago. 159 installs a week from pypi. It exposes 36 tools.

Agent-payable APIs on Kaspa: LLMs, chain data, covenants, zk proofs — pay per call, no API key

Installs per day peak 73 · avg 34 · -40% w/w

a month agotoday

Uptime history 51 days of history · worst day 71%

51 days agonow

96.7%

Uptime 24h

88 of 91 checks

Tools

read from the server

552 ms

Response time

average over 24h

159

Installs / week

npm and PyPI

K402 does not always answer

Over the last week it answered 94.7% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add k402 --transport http https://x402-compute.68cxgfyr0.workers.dev/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "k402": {
      "url": "https://x402-compute.68cxgfyr0.workers.dev/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.k402]
url = "https://x402-compute.68cxgfyr0.workers.dev/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "k402": {
      "url": "https://x402-compute.68cxgfyr0.workers.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "k402": {
      "url": "https://x402-compute.68cxgfyr0.workers.dev/mcp"
    }
  }
}

This one needs environment variables set before it will start: K402_GATEWAY (Gateway URL (defaults to the public k402 gateway)), K402_SESSION (Pin a funded session key (otherwise open_session mints one)). The author declared them in the registry entry; get the values from the project itself.

Available tools 36

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

covenant

covenant_address

Derive the covenant P2SH address for a compiled script on 'mainnet' or 'testnet-10'. Paid (~$0.0003).

covenant_broadcast

Broadcast a signed covenant tx (RpcTransaction JSON from covenant_build). MAINNET moves real KAS — run covenant_check first. Paid (~$0.0003).

covenant_build

Assemble a covenant spend tx. Each input: {txid, index, entry, compute_budget?, and either sigscript:{source,decl,args,is_leader?} to build a covenant sigscript server-side, or omit sigscript for a P2PK input you sign locally}. Each output: {amount, address|script_public_key_hex, covenant?:{authorizing_input,covenant_id}}. Returns the tx, a broadcast-ready rpc_transaction, fee accounting, and (if fully authorized) a pre-verify. We never sign. Paid (~$0.001).

covenant_check

Local txscript pre-verify of a signed covenant tx BEFORE broadcast — catches script failures that would otherwise cost you a broadcast. 'entries' are the spent UTXOs (covenant_utxos output plugs in directly). Returns {all_ok, inputs:[{index, ok, error?}]}. Paid (~$0.0005).

covenant_compile

Compile a Silverscript covenant to script hex, ABI, hardened template hash, and its P2SH address on each network. constructor_args is the silverc ctor JSON (e.g. [{"kind":"int","data":7}]). Paid (~$0.002). NOTE: 'compiles' ≠ proven on-chain.

covenant_utxos

Live UTXO set locked under a covenant address (covenant state inspection), from the node. Optionally filter by covenant_id. Paid (~$0.0003).

kaspa

kaspa_balance

Balance of any Kaspa MAINNET address, straight from a node (no indexer, no API key). Paid (~$0.00015 in KAS).

kaspa_fee_estimate

Current Kaspa mainnet feerate buckets (sompi per gram of tx mass). Paid (~$0.00015).

kaspa_network

Kaspa mainnet status: DAA score, block count, difficulty, node sync state. Paid (~$0.00015 in KAS).

kaspa_tx_status

Mempool status of a Kaspa transaction. Absent from mempool means accepted-or-unknown — confirm acceptance by checking one of its outputs with kaspa_utxos. Paid (~$0.00015).

kaspa_utxos

UTXO set of a Kaspa mainnet address, including scriptPublicKey and covenant_id where set. Paid (~$0.0003 in KAS).

prove

prove_guest_upload

Upload a RISC Zero program binary (the .bin risc0-build emits, base64) once; returns its content-addressed image_id (also the verification key), reusable across proofs. Paid (~$0.01).

prove_preflight

Execute a guest WITHOUT proving: exact cycle count + a signed price quote {total_cycles, price_kas, quote_id, quote_expires}. Run this first — proving cost scales with cycles by orders of magnitude. Paid (~$0.002).

prove_submit

Queue a proving job -> {job_id, cost_kas}. Pass quote_id (from prove_preflight; charged the quote) or max_kas (skip preflight; priced on actual cycles, refuses if over the cap). Then poll job_status and fetch job_result. Paid: the proof's cycle-based price (dynamic).

channel

channel_config

Parameters for opening a kaspa-channel — a covenant-enforced payment channel that settles per-call vouchers on Kaspa L1 with NO custodian (the trustless alternative to a prepaid session). Returns the payee pubkey, min/max channel size, required expiry lead, and maxfee. Free. Opening a channel means funding the channel covenant on-chain (payer holds the key), then paying per call with signed vouchers — use the `k402` Python client (`pip install k402`, k402.channel) to build the covenant and sign vouchers, since that flow needs your Kaspa key. Returns {error} if this gateway hasn't enabled the (experimental) channel rail.

channel_status

Status of a kaspa-channel by its channel id (covenant id): funded value, amount spent via vouchers, remaining, expiry, and whether it has been closed on-chain. Free.

job

job_result

Fetch a finished proving job's result {image_id, total_cycles, journal_b64, receipt_b64}. 404 until done; results kept 24h. Free.

job_status

Poll a proving job: queued/running/done/failed, queue position, cost. Free.

registry

registry_provider

Full detail on one provider in the service exchange by its payee pubkey: every service it lists, its chain-verified reputation (settled KAS volume + settlement count), and its payee address. Free.

registry_search

Discover providers in the k402 service exchange — an open marketplace of agent-payable services, each settled trustlessly over a Kaspa payment channel directly with the provider (no custodian). Filter by capability (e.g. 'summarize', 'llm:reason', 'zk-prove'), max USD price, and minimum reputation (settled KAS volume, chain-verified). Results are ranked reputation-first. Free. Returns each provider's endpoint, payee pubkey, price, channel terms, and reputation.

attest

attest_verify

Verify a RISC Zero receipt against an image_id -> {valid, journal_b64}. Anyone can check an attestation without trusting the prover. Paid (~$0.0002).

catalog

catalog

List every service this gateway sells (text tools, Kaspa chain data, LLM tiers) with live prices in KAS and USD. Free. Start here to see what's available and what calls cost.

classify

classify

Classify text into one (or multiple, if multi=true) of 2-32 labels; the result is constrained to your label set. Paid (~$0.0003 in KAS).

embed

embed_text

Embed up to 64 texts (768-dim vectors, nomic-embed-text). Paid (~$0.0003 in KAS).

extract

extract

Extract structured data from text as JSON guaranteed to match your JSON schema (schema-constrained decoding, not best-effort). Paid (~$0.0015 in KAS).

generate

generate

Run a prompt on a GPU model tier: 'chat' (fast 7B, ~$0.0015), 'llama' (budget 8B, ~$0.0008), 'reason' (35B, ~$0.004), 'think' (deep chain-of-thought 35B MoE, ~$0.004), 'code' (coder model, ~$0.0025), or 'kaspa-expert' (RAG-grounded, current Kaspa knowledge, ~$0.0015). Returns the completion text.

index

search_index

Store documents [{id, text, meta?}] in a named server-side collection for semantic search. Use an unguessable collection name and keep it secret. Paid (~$0.0015 in KAS).

open

open_session

Open a prepaid payment session: returns a session key and a personal Kaspa MAINNET deposit address. Send KAS to the address from any wallet (min 0.25 KAS); confirmed deposits become spendable balance within seconds and every paid tool call meters against it. Free. The session is saved locally so subsequent calls use it automatically.

pay

pay_per_call

Complete a PER-CALL coin payment. After a paid tool returns a 402 with pay_per_call_offers, pay one offer on-chain from your own wallet, then call this with the 402's `endpoint` and `request_body`, the chosen offer's `scheme` and `payment_id`, and your payment `txid`. The gateway verifies the payment landed and returns the tool's real result. (Alternative to a prepaid session — use this when you'd rather pay each call directly in a specific coin.)

payment

payment_options

Which coins and schemes this gateway accepts for payment. Free. Ways to pay any paid tool: a prepaid KAS session (open_session — simplest, no per-call step); per-call in any listed coin (pay the offer a 402 returns, then pay_per_call); or, where the experimental 'kaspa-channel' scheme is offered, a covenant payment channel that settles per-call vouchers on L1 with no custodian (see channel_config). Coins may include Kaspa, Pearl, BTC, LTC, DOGE, BCH, DASH, and EVM assets (ETC, ETH, USDC, USDT).

rewrite

rewrite

Rewrite text per an instruction (tone, format, length...). Paid (~$0.001 in KAS).

search_query

Semantic-search a collection you indexed earlier; returns top-k matches with scores. Paid (~$0.0003 in KAS).

session

session_status

Check the current payment session: deposit address, deposited / spent / remaining KAS. Free.

summarize

summarize

Summarize text or a public URL in at most max_words. Paid (~$0.001 in KAS).

url

read_url

Fetch a public web page and return its title + clean markdown; distill=true adds key-fact bullets. Useful when you have no web access of your own. Paid (~$0.0012 in KAS).

use

use_session

Attach an existing k402 session key (from a previous open_session) so paid calls meter against its balance — use after reconnecting to the hosted endpoint, or to carry one funded session across clients. Returns the session's current balance. Free.

Endpoints

URL	Transport	State	Latency	Checked
https://x402-compute.68cxgfyr0.workers.dev/mcp	streamable-http	answering	489 ms	2 min ago

Alternatives to K402

same job, measured the same way

Kx402

by kali123411

Kaspa x402 agent payer — pay x402 v2 services on Kaspa (KAS) per call, no account or API key

26 installs/wk local only

Boo X402 MCP

by lucle87

Pay-per-call crypto data for AI agents. USDC on Base via x402. No API key.

34 installs/wk local only

Boo Mpp MCP

by lucle87

Pay-per-call crypto data for AI agents. USDC.e on Tempo via MPP. No API key.

27 installs/wk local only

Clink Forge

by clinkforge

Pay-per-call government data over x402: provenance chains, Ed25519 attestations, no API keys.

121 tools answering

Mercury X402 MCP

by mercuryx402

Agent-payable web data over x402: 18 keyless services an agent pays per call.

30 installs/wk 18 tools answering

X402 API

by fernsugi

DeFi data API for AI agents — pay-per-call via x402/USDC on Base

39 installs/wk local only

Nodeflare MCP

by nodeflare-app

Blockchain JSON-RPC on 23 EVM chains for AI agents - free tier, API key, or x402 pay-per-call.

58 installs/wk local only

X402 Tools MCP

by mizukaizen

melis x402 Tools — 22 pay-per-call APIs for AI agents. No accounts, no API keys. USDC on Base.

56 installs/wk local only

K402 — questions

Answers built from our own checks of this server.

What can K402 do?

It exposes 36 tools, read directly from the server on our last check. Among them: attest_verify, catalog, channel_config, channel_status, classify, covenant_address and 30 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is K402 mostly used for?

Its tools cluster around covenant, kaspa and prove. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is K402 working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 88 of 91 checks got a reply (96.7%), average response time 552 ms. The bar chart above shows every period we have measured.

How do I connect K402?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does K402 need an API key?

No. K402 completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 36 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is K402?

It answers our handshake in 552 ms on average, which is faster than 27% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use K402?

The pypi package k402-mcp was installed 159 times in the last week. Week over week that is -40%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.