Skip to main content

MCP client: your agent buys verified inference bursts and pays only if the answer is correct (x402, BYOK).

Project description

verified-burst

An MCP tool that lets your agent buy verified inference at hard decisions and pay only if the answer is correct. At an irreversible/ambiguous/deadline fork, your agent escalates to fast silicon, samples best-of-N, runs the answers through a verifier, and pays a few tenths of a cent over x402 — charged only if it passes. Non-verified results cost nothing. Budget-capped, BYOK.

Install

pip install verified-burst
# or zero-install:  uvx verified-burst   (pipx run verified-burst)

Add to your MCP client

{
  "mcpServers": {
    "verified-burst": {
      "command": "verified-burst",
      "env": {
        "BURST_BUYER_KEY": "0x<your Base wallet private key>",
        "BURST_PROVIDER_KEY": "csk-<your Cerebras key>"
      }
    }
  }
}

Fund the wallet with a little USDC on Base. BURST_PROVIDER_KEY is optional (BYOK — your tokens, your rate limit). BURST_ENDPOINT overrides the host (default https://solcleus.com/v1/burst).

The tool

buy_verified_burst(request, strategy="best_of_n", n=3, verifier="self_consistency", answer_key=None, model=None)

buy_verified_burst(
  request="Is this clause enforceable? yes/no",
  answer_key=["regex", "(yes|no)"]
)

Returns the verified answer + a receipt. You are charged only when the verifier passes. Spend is capped per wallet server-side, so autonomous purchases are safe.

How the money moves (no mystery)

  1. The endpoint answers an unpaid call with HTTP 402 + payment requirements.
  2. This client signs an x402 (EIP-3009) authorization with your wallet and retries.
  3. The host verifies the answer and settles on-chain only if it passed — your USDC moves directly to the provider; the host eats the gas. Self-hosted facilitator, no third party holding funds.

Service discovery: GET https://solcleus.com/.well-known/x402.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

verified_burst-1.0.0.tar.gz (5.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

verified_burst-1.0.0-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file verified_burst-1.0.0.tar.gz.

File metadata

  • Download URL: verified_burst-1.0.0.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for verified_burst-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ba4fd37f6b969ac3ab83bbfe4d3bb54e3f7a661baebd5fbaf39b443e36324d3b
MD5 b0d0ce9e63cf1532e9efbc57cb25cf6d
BLAKE2b-256 0e566da60804e776a167cbe945b8b2b280c5109430bb0e83c9e003952c6169a9

See more details on using hashes here.

File details

Details for the file verified_burst-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: verified_burst-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for verified_burst-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c45ea8b4e6e62d6a62dbc87ca30f347884cbfb77e46c0d65085558f0cb4fa071
MD5 368266339c877f3c651dc28a17b777bd
BLAKE2b-256 aa313a7df27e04dcc0ab6bf528dbfb87d930a288c2cb729e14b3b8145bc6428f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page