# HALOWERK Developer Tools One public MCP server, five tools. No subscription is required. MCP URL: https://halowerk.com/buyers/mcp Transport: stateless Streamable HTTP (JSON responses), protocol 2025-06-18. Discovery: https://halowerk.com/.well-known/mcp.json OpenAPI: https://halowerk.com/buyers/openapi.json Call tools/list for input schemas. Call a tool without payment first. Its result has isError:true and identical PaymentRequired data in structuredContent and content[0].text. Pay the exact live quote with USDC on Base and retry with the PaymentPayload object in params._meta["x402/payment"]. A successful paid call returns result._meta["x402/payment-response"]. Keep that receipt; never automatically repeat an uncertain payment. ## technology_stack Detect a website’s CMS, frameworks and hosting technology for integration planning. 0.005 USDC per request. Example arguments: ```json { "url": "https://example.com/" } ``` ## domain_profile Get technology, DNS, mail security, TLS and hosting findings in one domain profile. 0.035 USDC per request. Example arguments: ```json { "domain": "example.com" } ``` ## ip_reputation Screen one IP for reputation risks for 0.001 USDC, or check a batch of up to 100 IPs for 0.050 USDC. Example arguments: ```json { "mode": "single", "input": { "ip": "1.1.1.1" } } ``` ## speech_to_text Turn audio into timestamped text with optional speaker separation. Transcription: 0.020 USDC; speaker separation: 0.025 USDC per started minute (1–30). Example arguments: ```json { "mode": "diarize", "input": { "source": { "url": "https://halowerk.com/buyers/example.wav" }, "duration_minutes": 1, "language": "en" } } ``` ## email_batch Check email syntax, domain routing and disposable-address signals in one batch. 0.0006 USDC per address, minimum 0.001 USDC per request; up to 100 addresses. Example arguments: ```json { "emails": [ "not-an-email", "also-not-an-email" ], "smtp_check": false } ``` These examples were probed without payment (402). The short audio is synthetic speech generated locally with the existing FFmpeg flite filter (no personal data). Use your own authorized recording for speech recognition. Email examples are deliberately invalid strings, with no personal data or SMTP delivery. IP batch mode: {"mode":"batch","input":{"ips":["1.1.1.1","8.8.8.8"]}}. Transcription without speakers: use mode "stt". Public API calls POST JSON to /buyers/api/TOOL_NAME and accept standard PAYMENT-SIGNATURE headers. Prices and execution come from the existing HALOWERK services. ## API-key credit (live) Create an account with POST https://halowerk.com/buyers/accounts and an empty JSON object. The response shows api_key once. Save it in your secret manager. The server stores its hash. Never put the key in a URL. Use Authorization: Bearer YOUR_KEY on all account and credit requests. POST /buyers/topups with {"amount_usdc":"0.20"} to see the x402 v2 payment requirement. Pay that exact quote on Base and retry with PAYMENT-SIGNATURE. The credited amount is spendable across all five tools at the same live per-call prices. Top-ups from0.10 through100.00 USDC are accepted; no volume discount or expiry. Reusing the same payment cannot create more credit. A conflicting account cannot claim it. GET /buyers/balance returns available_usdc, reserved_usdc, credited_usdc and spent_usdc with six decimal places. GET /buyers/usage returns up to100 recent calls for your key only. A top-up is one payment; consumption is recorded separately as prepaid_usage. POST JSON to /buyers/api/TOOL_NAME with Authorization: Bearer YOUR_KEY and a unique Idempotency-Key header (8–100 letters, digits, _ or -). Use the same argument shapes shown above. Calls reserve the live quoted amount atomically and debit only after a successful result. Failed calls restore the reservation. The response billing object includes the charged amount and balance. A repeated Idempotency-Key returns409 instead of executing again. The limit is60 attempts per minute and at most two in-flight calls per key. Example: ```sh curl https://halowerk.com/buyers/api/technology_stack \ -H "Authorization: Bearer $HALOWERK_API_KEY" \ -H "Idempotency-Key: your-unique-request-0001" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com/"}' ``` Without an Authorization header, these gateway API routes accept ordinary x402 payments and return the original provider challenge when unpaid. Existing provider URLs remain available. If a process fails while work is running, a reservation can remain pending. Do not generate a new payment or new request ID to retry automatically. Keep the usage ID and ask HALOWERK to reconcile the reservation. This service stores billing metadata, not your raw request or result for later replay. Card top-ups are currently disabled. USDC funding is live; a user who receives credit can consume it with an API key without a wallet.