{"service":"Agent Error Fix Receipt","version":"2026-05-25-d1-revenue-log","source_of_truth":"openapi","canonical_openapi_url":"/openapi.json","free_to_paid_flow":{"free":["MCP discovery, planning, filtering, and handoff","Local preview and dry-run requests","A human opening an official X search URL in a browser"],"upgrade_required_when":["An agent automates production use of a generated search URL","An agent performs automated external collection or paid execution","A client requests a paid route result"],"upgrade_not_required_when":["The client is only discovering tools or reading schemas","The client is using planning, filtering, handoff, preview, or dry-run features","A human manually opens the official X URL"],"steps":["Read /openapi.json and /payment-options.json.","POST the paid operation without proof to receive HTTP 402 and PAYMENT-REQUIRED.","Obtain x402 payment proof through the client wallet/facilitator.","Retry the same POST with payment proof and expect HTTP 200."]},"currency":"USD","price":"0.01","display_price":"$0.01","mode":"mainnet","network":"eip155:8453","testnet":false,"real_revenue":true,"notice":"Mainnet staging is configured. Real USDC payments are enabled only after a paid request settles successfully.","payment_methods":[{"type":"x402","status":"active","endpoint":"/fix-error","pay_to":"0x4D7d842536De9Eb491AE2300126B3CDdE7B0aDE3","facilitator":"cdp"},{"type":"human","status":"explainer-only","endpoint":"/buy"}],"free":{"endpoints":["/","/fix-error/preview","/agent.json","/.well-known/agent.json","/pricing.json","/llms.txt","/buy"],"includes":"Service discovery, schemas, price, safety notes, and human explanation."},"paid":{"endpoint":"/fix-error","includes":"Structured JSON repair receipt after valid x402 payment proof.","unpaid_status":402,"retry":"After payment, retry the same POST /fix-error request with x402 payment proof.","operations":[{"endpoint":"/fix-error","method":"POST","purpose":"Return a structured repair receipt for a failed command or agent error.","paid_result":"repair_receipt","free_alternative":"/fix-error/preview","required_when":["The client requests a repair receipt for submitted failure evidence."],"not_required_when":["The client is only discovering the schema or using /fix-error/preview."],"resource_url":"https://api.kgninja.dev/fix-error","protocol":"x402","network":"eip155:8453","currency":"USDC","price":"$0.01","expected_unpaid_response":402,"expected_paid_response":200},{"endpoint":"/summarize-url","method":"POST","purpose":"Return a title and short summary for a public URL.","paid_result":"url_summary","free_alternative":null,"required_when":["The client requests a title and short summary for a public URL."],"not_required_when":["The client is only discovering the schema."],"resource_url":"https://api.kgninja.dev/summarize-url","protocol":"x402","network":"eip155:8453","currency":"USDC","price":"$0.01","expected_unpaid_response":402,"expected_paid_response":200},{"endpoint":"/shell-risk-check","method":"POST","purpose":"Classify shell command risk before execution.","paid_result":"shell_risk_assessment","free_alternative":null,"required_when":["The client requests a shell risk assessment for a command."],"not_required_when":["The client is only discovering the schema."],"resource_url":"https://api.kgninja.dev/shell-risk-check","protocol":"x402","network":"eip155:8453","currency":"USDC","price":"$0.01","expected_unpaid_response":402,"expected_paid_response":200},{"endpoint":"/agent-visibility-report","method":"POST","purpose":"Return a privacy-safe aggregate machine-discovery and payment-readiness report.","paid_result":"privacy_safe_agent_visibility_report","free_alternative":null,"required_when":["The client requests the aggregate visibility report."],"not_required_when":["The client is only discovering the schema."],"resource_url":"https://api.kgninja.dev/agent-visibility-report","protocol":"x402","network":"eip155:8453","currency":"USDC","price":"$0.01","expected_unpaid_response":402,"expected_paid_response":200},{"endpoint":"/hyperxosist-query","method":"POST","purpose":"Generate a clean query and official X search URL for automated production use.","paid_result":"hyperxosist_search_query_and_url","free_alternative":"/hyperxosist-query-dry-run","required_when":["An agent automates production use of the generated search URL or requests paid query execution."],"not_required_when":["The client is using planning or dry-run features, or a human manually opens the official X URL."],"resource_url":"https://api.kgninja.dev/hyperxosist-query","protocol":"x402","network":"eip155:8453","currency":"USDC","price":"$0.01","expected_unpaid_response":402,"expected_paid_response":200}]},"featured_paid_routes":[{"route":"/fix-error","purpose":"Recover from command, build, or runtime failures."},{"route":"/summarize-url","purpose":"Return title plus short summary for a public URL."},{"route":"/shell-risk-check","purpose":"Score shell command risk before execution."},{"route":"/hyperxosist-query","purpose":"Generate a paid X search query and search URL with HyperXosist noise reduction."},{"route":"/agent-visibility-report","purpose":"Unlock observed machine-discovery patterns, privacy-safe aggregate scoring, and one actionable next fix for payment-readiness.","paid_result_type":"privacy_safe_agent_visibility_report","paid_result_includes":["agent_visibility_score","payment_readiness_score","machine_discovery_score","detected_gaps","matched_real_world_patterns","recommended_next_fix","privacy_guarantee"],"value_proposition":"Payment returns aggregate discovery and payment-readiness signals, not a generic AI summary."}],"claims":{"guaranteed_fix":false,"production_revenue_claimed":false}}