crackthe-mcp

An MCP server that gives any agent the ability to buy a contract-grade work breakdown.

One crack_scope call = one x402 payment ($0.25 in USDC on Base mainnet) = one decompose from the wellsyn'cc engine: measurable outcomes, acceptance criteria, a verification method per outcome, and payout bands. The result includes the on-chain settlement receipt (tx hash), so the agent can cite proof of purchase.

Tools

• crack_scope (paid, $0.25/call, ~30-60s): a plain-language brief, local scope documents via files (PDF, images, docx/pptx/xlsx, text; paths on this machine), or both. Out come the breakdown JSON, the settlement receipt, and (by default) a hosted viewUrl: a shareable rendered page on crackthe.work with prices masked. host: false keeps the result fully private; optional budgetHintUsdt allocates payouts against a total.
• crack_wallet_status (free): payer address, USDC balance on Base, calls remaining.

Wallet setup

The server pays from a local key. Use a dedicated wallet holding a few dollars of USDC, never your main wallet.

1. Create a fresh key (any EVM wallet, or openssl rand -hex 32 prefixed with 0x).
2. Send USDC to its address on the Base network ($5 = 20 calls). No ETH needed: payments are EIP-3009 authorizations signed locally; the facilitator pays gas.
3. Give the key to the server, either way:
   • env: CRACK_PRIVATE_KEY=0x...
   • macOS Keychain (no env needed): security add-generic-password -a x402-test -s x402-test-wallet -w "0x..."

The key never leaves the process and is never logged; it only signs payment authorizations for the gateway.

Hook it into an agent

Claude Code:

claude mcp add crack -e CRACK_PRIVATE_KEY=0x... -- npx -y crackthe-mcp

Cursor / other MCP clients (.mcp.json / mcp.json):

{
  "mcpServers": {
    "crack": {
      "command": "npx",
      "args": ["-y", "crackthe-mcp"],
      "env": { "CRACK_PRIVATE_KEY": "0x..." }
    }
  }
}

(Inside the wellsyncc repo, .mcp.json runs the local server.mjs directly.)

Then ask the agent to "crack this scope: ..." — it will check the wallet, pay, and return the breakdown.

Config

| env | default | | | --- | --- | --- | | CRACK_PRIVATE_KEY | Keychain fallback | payer key, 0x + 64 hex | | CRACK_GATEWAY_URL | https://x402.crackthe.work | x402 gateway |

Public docs for the API and this server: https://dev.crackthe.work