KnownFix
Verified fixes, professional reviews, and evidence-led apparel over MCP.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,628Tokens (tool definitions)
~4.5 KBTypical response size
Significant attention impact (5.96% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"knownfix": {
"command": "npx",
"args": [
"knownfix"
]
}
}
}Runnable packages
npmknownfix
0.3.17stdioRemote endpoints
https://knownfix-backend-28.b-hash88.deno.net/mcpstreamable-httpWhat it can do
Tool inventory
Tools (17)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_fixes(query)
Use this first for an exact error or distinctive symptom. Returns up to three confident ranked matches. A free top match includes the full fix. A paid top match includes a free diagnosis, confidence and compatibility, dollar price, signed USDC/Base Pay and exact-ETH rails, and one pay-and-redeem action; do not call get_offer. Use list_catalog to browse, get_fix only with a known id or payment proof, and request_fix only after an honest miss.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Preserve the exact error code and distinctive text; add tool or runtime context needed to disambiguate it. Omit credentials, tokens, private hostnames, and private paths."
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The exact query that was evaluated."
},
"matches": {
"type": "array",
"description": "Confident ranked matches; empty means KnownFix is not claiming a match.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"signature": {
"type": "string"
},
"confidence": {
"type": "string"
},
"match": {
"type": "number"
},
"sample": {
"type": "boolean"
}
},
"required": [
"id",
"title",
"signature",
"confidence",
"match"
],
"additionalProperties": true
}
},
"miss": {
"type": "boolean"
},
"topMatchTier": {
"type": "string",
"enum": [
"free-sample",
"paid"
]
},
"fix": {
"type": "object",
"description": "Full fix, present only when the top match is free.",
"additionalProperties": true
},
"purchase": {
"type": "object",
"properties": {
"checkout": {
"type": "string",
"enum": [
"ready",
"unavailable"
],
"description": "Whether both signed payment rails were issued."
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"confidence": {
"type": "string"
},
"compatibility": {
"type": "object",
"additionalProperties": true
},
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"relatedBundle": {
"type": "object",
"additionalProperties": true
},
"recommendation": {
"type": "object",
"description": "Demand evidence and matched-fix context when a multi-fix pack is the recommended purchase.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
}
},
"required": [
"checkout",
"price",
"nextAction"
],
"additionalProperties": true,
"description": "Purchase-ready diagnosis, signed offers, payment rails, and the single next action for a paid top match."
}
},
"required": [
"query",
"matches"
],
"additionalProperties": true
}🟡request_fix(signature, context, publish)
Ask for a fix this store does not have yet. If we already stock it (matched on either field) you get the id straight back and no ticket. Otherwise you get a ticket; when we stock THAT fix, check_request returns it to you FREE, once. A ticket only ever redeems a fix created after the request: fixes that already existed when you asked are not free, whatever the request said. No contact details are collected. Set publish: true ONLY if the text may appear on a public wanted board — never include secrets, tokens, internal hostnames, or file paths.
Input Schema
{
"type": "object",
"properties": {
"signature": {
"type": "string",
"description": "The exact error text you are stuck on"
},
"context": {
"type": "string",
"description": "What you already tried, and the tool/runtime versions"
},
"publish": {
"type": "boolean",
"description": "Allow this text on the public board (default false)"
}
},
"required": [
"signature"
]
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable validation or quota failure."
},
"detail": {
"type": "string",
"description": "Human-readable failure detail."
},
"status": {
"type": "string",
"enum": [
"already-stocked",
"recorded"
]
},
"fixId": {
"type": "string",
"description": "Existing catalog id when no ticket was needed."
},
"match": {
"type": "number",
"description": "Existing-fix match score."
},
"ticket": {
"type": "string",
"pattern": "^req_[0-9a-f]{32}$"
},
"requestId": {
"type": "string",
"format": "uuid"
},
"published": {
"type": "boolean"
},
"note": {
"type": "string",
"description": "Required next step and ticket handling guidance."
}
},
"additionalProperties": false
}🟡check_request(ticket)
Check a private ticket from request_fix. Returns pending, declined, not-eligible, redeemed, or the full fix free once an eligible new fix is stocked. This call may atomically consume the ticket's one-time delivery, so save the returned body. Use get_fix when you already have a catalog id; do not create another request while this ticket is pending.
Input Schema
{
"type": "object",
"properties": {
"ticket": {
"type": "string",
"description": "Private req_ ticket returned once by request_fix. Reuse it unchanged and never publish it. A stocked eligible result can be redeemed only once, so save the returned fix body."
}
},
"required": [
"ticket"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable ticket or fulfillment failure."
},
"detail": {
"type": "string",
"description": "Human-readable failure or eligibility detail."
},
"status": {
"type": "string",
"enum": [
"pending",
"declined",
"not-eligible",
"stocked",
"redeemed"
]
},
"requestId": {
"type": "string",
"format": "uuid"
},
"receivedAt": {
"type": "string",
"format": "date-time"
},
"fixId": {
"type": "string"
},
"reason": {
"type": "string"
},
"fix": {
"type": "object",
"description": "Full fix body on the ticket's single eligible free delivery.",
"additionalProperties": true
},
"note": {
"type": "string",
"description": "Current state and recommended next step."
}
},
"additionalProperties": false
}🟢list_catalog
Browse every stocked error signature, title, tag, confidence label, and free-sample flag without ranking or creating an offer. Use search_fixes instead when diagnosing a specific error; it returns the best match and any purchase-ready checkout.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"store": {
"type": "string"
},
"tagline": {
"type": "string"
},
"tier": {
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"spec",
"store",
"tier",
"entries"
],
"additionalProperties": true
}🟢list_skills
Compare premium skills and multi-fix bundles. Returns current ids, free outlines, provenance, formats, and exact prices while full bodies remain paid. Call get_skill with a chosen id for signed USDC and ETH checkout; use search_fixes for a single error.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"tier": {
"type": "string"
},
"howToBuy": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"spec",
"tier",
"howToBuy",
"skills"
],
"additionalProperties": true
}🟢list_merch
Browse the KnownFix Merch Store. Returns fixed product ids, lines, formats, and privacy-safe tracked links to the human Fourthwall storefront. Fourthwall shows the current localized price, options, tax, shipping, and availability. This tool does not place an order or collect checkout data.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"store": {
"type": "string"
},
"storefront": {
"type": "string",
"format": "uri"
},
"fulfilledBy": {
"type": "string"
},
"checkout": {
"type": "string"
},
"privacy": {
"type": "string"
},
"products": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"spec",
"store",
"storefront",
"fulfilledBy",
"checkout",
"privacy",
"products"
],
"additionalProperties": false
}🟢list_services
Compare KnownFix's $49 website first-look report and deeper website, public-codebase, agent-commerce, and release-pipeline reviews. Returns bounded scope, deliverables, delivery time, limitations, sample-report links where available, and exact prices. Call order_service only after choosing a service and confirming authority over the public target.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"currency": {
"type": "string"
},
"privacy": {
"type": "string"
},
"services": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"spec",
"currency",
"privacy",
"services"
],
"additionalProperties": true
}🟡order_service(serviceId, targetUrl, notes, publishTarget, authorizationConfirmed)
Create a private ticket and signed Base USDC/ETH checkout for one published professional service. Accepts public HTTPS websites or public GitHub repositories only. Never include credentials, tokens, secrets, private repository URLs, or confidential data. The returned svc_ ticket is shown once and is the only report-retrieval credential.
Input Schema
{
"type": "object",
"properties": {
"serviceId": {
"type": "string",
"enum": [
"website-growth-audit",
"codebase-review",
"agent-commerce-audit",
"release-pipeline-review"
]
},
"targetUrl": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public HTTPS website or exact public GitHub repository URL. Do not include credentials, query parameters, or fragments."
},
"notes": {
"type": "string",
"maxLength": 1500,
"description": "Optional review focus. Never include credentials, tokens, secrets, private URLs, or confidential data."
},
"publishTarget": {
"type": "boolean",
"description": "Optional explicit consent to show the target and status in the public work queue. Defaults to false."
},
"authorizationConfirmed": {
"type": "boolean",
"description": "Must be true: confirms the target is public and the requester is authorized to commission a passive, non-destructive review."
}
},
"required": [
"serviceId",
"targetUrl",
"authorizationConfirmed"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"status": {
"type": "string"
},
"ticket": {
"type": "string"
},
"service": {
"type": "object",
"additionalProperties": true
},
"purchase": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}🟢check_service_order(ticket, paymentTx, paymentOffer)
Check a private service order by its svc_ ticket. With paymentTx and paymentOffer, atomically confirms exactly one matching Base payment and moves the order into review. Without payment fields, returns current status; once complete, it returns the private Markdown report and SHA-256 digest. Keep the ticket and signed offer private.
Input Schema
{
"type": "object",
"properties": {
"ticket": {
"type": "string",
"pattern": "^svc_[0-9a-f]{32}$",
"description": "Private bearer ticket returned once by order_service."
},
"paymentTx": {
"type": "string",
"description": "Base Pay UserOperation hash for USDC or mined Base transaction hash for ETH. Omit after payment is confirmed."
},
"paymentOffer": {
"type": "string",
"maxLength": 2048,
"description": "Matching private signed offer returned by order_service. Omit after payment is confirmed."
}
},
"required": [
"ticket"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"status": {
"type": "string"
},
"service": {
"type": "object",
"additionalProperties": true
},
"reportMarkdown": {
"type": "string"
},
"reportSha256": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"properties": {
"spec": {
"type": "string",
"enum": [
"knownfix-payment-receipt/1.0"
]
},
"scheme": {
"type": "string",
"enum": [
"base-pay-usdc",
"base-exact-eth"
]
},
"custody_model": {
"type": "string",
"enum": [
"direct-settlement"
]
},
"reversal_supported": {
"type": "boolean",
"const": false
},
"lifecycle": {
"type": "object",
"properties": {
"authorization": {
"type": "string",
"enum": [
"offer-verified"
]
},
"settlement": {
"type": "string",
"enum": [
"confirmed"
]
},
"fulfillment": {
"type": "string",
"enum": [
"pending",
"released",
"declined"
]
}
},
"required": [
"authorization",
"settlement",
"fulfillment"
],
"additionalProperties": false
},
"proof": {
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base-mainnet"
]
},
"chain_id": {
"type": "integer",
"const": 8453
},
"type": {
"type": "string",
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
]
}
},
"required": [
"network",
"chain_id",
"type"
],
"additionalProperties": false
}
},
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"additionalProperties": false
}
},
"additionalProperties": true
}🟢audit_endpoint(paymentTx, paymentOffer, url)
Readiness audit of any agent-facing URL: MCP handshake, CORS, discovery docs (llms.txt, mcp.json), and payment-offer behaviour. First call with url alone for the FREE grade and failing-check list. For the full findings and remediations, call get_offer with productType "audit" and productId "conformance-report", pay, then call audit_endpoint again with the same url plus paymentTx and paymentOffer. This tool both previews and redeems the paid report; no separate delivery tool is needed.
Input Schema
{
"type": "object",
"properties": {
"paymentTx": {
"type": "string",
"description": "Base Pay UserOperation hash for USDC or Base transaction hash for ETH, for the full paid report"
},
"paymentOffer": {
"type": "string",
"description": "Signed offer token from get_offer (productType: audit)"
},
"url": {
"type": "string",
"format": "uri",
"description": "Base URL to audit, e.g. https://your-agent.example.com"
}
},
"required": [
"url"
]
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable failure code."
},
"target": {
"type": "string",
"description": "Canonical URL that was audited."
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"grade": {
"type": "string",
"description": "Overall readiness grade."
},
"summary": {
"type": "object",
"additionalProperties": true
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"check": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pass",
"warn",
"fail",
"na"
]
},
"detail": {
"type": "string",
"description": "Paid report finding; omitted from the free grade."
},
"remediation": {
"type": "string",
"description": "Paid remediation; omitted from the free grade."
}
},
"required": [
"check",
"status"
],
"additionalProperties": false
}
},
"tier": {
"type": "string",
"enum": [
"free-grade",
"full-report"
]
},
"paidReport": {
"type": "object",
"description": "Purchase instructions included with an unpaid report.",
"additionalProperties": true
},
"paymentDeclined": {
"type": "string"
},
"soldTo": {
"type": "string"
},
"via": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"properties": {
"spec": {
"type": "string",
"enum": [
"knownfix-payment-receipt/1.0"
]
},
"scheme": {
"type": "string",
"enum": [
"base-pay-usdc",
"base-exact-eth"
]
},
"custody_model": {
"type": "string",
"enum": [
"direct-settlement"
]
},
"reversal_supported": {
"type": "boolean",
"const": false
},
"lifecycle": {
"type": "object",
"properties": {
"authorization": {
"type": "string",
"enum": [
"offer-verified"
]
},
"settlement": {
"type": "string",
"enum": [
"confirmed"
]
},
"fulfillment": {
"type": "string",
"enum": [
"pending",
"released",
"declined"
]
}
},
"required": [
"authorization",
"settlement",
"fulfillment"
],
"additionalProperties": false
},
"proof": {
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base-mainnet"
]
},
"chain_id": {
"type": "integer",
"const": 8453
},
"type": {
"type": "string",
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
]
}
},
"required": [
"network",
"chain_id",
"type"
],
"additionalProperties": false
}
},
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"additionalProperties": false
}
},
"additionalProperties": true
}🟢audit_theme(url)
Run a read-only theme audit on a public HTTP(S) page, free in full. Fetches but never modifies the page, then checks inline style CSS for brace errors, token gaps, incomplete dark themes, missing body backgrounds, and WCAG body-text contrast. External stylesheets are counted but not fetched. Use audit_endpoint instead for MCP, CORS, discovery, and payment readiness.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Public HTTP(S) page to fetch and inspect. Direct localhost, .local, loopback, private IPv4, and IPv6-literal targets are rejected. Inline style CSS is analyzed; external stylesheets are not fetched."
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable target or fetch failure."
},
"reason": {
"type": "string",
"description": "Why the target URL was rejected."
},
"detail": {
"type": "string",
"description": "Fetch failure detail."
},
"spec": {
"type": "string",
"enum": [
"knownfix-theme-audit/0.1"
]
},
"target": {
"type": "string",
"format": "uri",
"description": "Canonical page URL inspected."
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"grade": {
"type": "string",
"enum": [
"ready",
"mostly-ready",
"needs-work"
],
"description": "Overall grade derived from the check counts."
},
"summary": {
"type": "object",
"properties": {
"pass": {
"type": "integer",
"minimum": 0
},
"warn": {
"type": "integer",
"minimum": 0
},
"fail": {
"type": "integer",
"minimum": 0
},
"na": {
"type": "integer",
"minimum": 0
}
},
"required": [
"pass",
"warn",
"fail",
"na"
],
"additionalProperties": false
},
"checks": {
"type": "array",
"description": "Every inline-CSS theme, token, background, and contrast finding.",
"items": {
"type": "object",
"properties": {
"check": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pass",
"warn",
"fail",
"na"
]
},
"detail": {
"type": "string"
},
"remediation": {
"type": "string"
}
},
"required": [
"check",
"status",
"detail"
],
"additionalProperties": false
}
},
"note": {
"type": "string",
"description": "Audit coverage and inline-style limitation."
}
},
"additionalProperties": false
}🟢get_offer(productType, productId, currency)
Create or refresh a one-hour signed bearer offer for a chosen skill, bundle, audit, or fix. Do not call this after a paid search_fixes result or an unpaid get_fix/get_skill result because those responses already include both payment rails. Choose USDC for Base Pay or ETH for exact wei; with no product arguments, this returns the general settlement document.
Input Schema
{
"type": "object",
"properties": {
"productType": {
"type": "string",
"enum": [
"fix",
"skill",
"audit",
"service"
],
"description": "Catalog shelf that owns the product id; bundles use skill."
},
"productId": {
"type": "string",
"description": "Exact fix, skill, bundle, or audit product id."
},
"currency": {
"type": "string",
"enum": [
"USDC",
"ETH"
],
"description": "Settlement rail. Defaults to ETH for backward compatibility."
}
}
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable product, currency, or checkout failure."
},
"detail": {
"type": "string",
"description": "Human-readable failure detail."
},
"spec": {
"type": "string",
"description": "Offer or settlement-document specification."
},
"productType": {
"type": "string",
"enum": [
"fix",
"skill",
"audit",
"service"
]
},
"productId": {
"type": "string"
},
"currency": {
"type": "string",
"enum": [
"USDC",
"ETH"
]
},
"priceUsd": {
"type": "string"
},
"token": {
"type": "string",
"description": "Private signed bearer purchase credential; never publish it."
},
"tokenHandling": {
"type": "string"
},
"baseAmountUsdcAtomic": {
"type": "string"
},
"amountUsdcAtomic": {
"type": "string"
},
"amountUsdc": {
"type": "string"
},
"usdcContract": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"basePay": {
"type": "object",
"additionalProperties": true
},
"basePriceWei": {
"type": "string"
},
"priceWei": {
"type": "string"
},
"priceEth": {
"type": "string"
},
"paymentUri": {
"type": "string"
},
"payTo": {
"type": "string"
},
"chainId": {
"type": "integer"
},
"network": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"redemption": {
"type": "object",
"additionalProperties": true
},
"rule": {
"type": "string"
},
"servedBy": {
"type": "string"
},
"offer": {
"type": "object",
"additionalProperties": true
},
"backend": {
"type": "object",
"additionalProperties": true
},
"settlement": {
"type": "object",
"additionalProperties": true
},
"catalog": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}🟢report_checkout_blocker(productType, productId, paymentOffer, blocker)
Use only after a signed KnownFix checkout cannot proceed before a payment hash exists. Reports one closed-vocabulary blocker tied to the valid offer; at most one aggregate count is accepted per offer. No wallet address, token, transaction hash, query, or free-form text is published. Do not call after payment; redeem with get_fix, get_skill, or audit_endpoint instead.
Input Schema
{
"type": "object",
"properties": {
"productType": {
"type": "string",
"enum": [
"fix",
"skill",
"audit",
"service"
],
"description": "Product shelf encoded in the signed offer."
},
"productId": {
"type": "string",
"maxLength": 120,
"description": "Exact product id encoded in the signed offer."
},
"paymentOffer": {
"type": "string",
"maxLength": 2048,
"description": "Private signed offer returned by KnownFix. It is verified, never returned, and never published."
},
"blocker": {
"type": "string",
"enum": [
"no-compatible-wallet",
"funding-unavailable",
"insufficient-balance",
"base-pay-unavailable",
"payment-rejected",
"payment-failed"
],
"description": "Observed pre-payment stopping point. Use funding-unavailable when no practical funding path exists; insufficient-balance when a compatible wallet exists but lacks the required asset."
}
},
"required": [
"productType",
"productId",
"paymentOffer",
"blocker"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Machine-readable validation failure."
},
"detail": {
"type": "string",
"description": "Safe failure detail."
},
"status": {
"type": "string",
"enum": [
"recorded",
"already-recorded",
"operator-test"
]
},
"blocker": {
"type": "string",
"enum": [
"no-compatible-wallet",
"funding-unavailable",
"insufficient-balance",
"base-pay-unavailable",
"payment-rejected",
"payment-failed"
]
},
"rail": {
"type": "string",
"enum": [
"USDC",
"ETH"
]
},
"privacy": {
"type": "string"
},
"nextAction": {
"type": "string"
}
},
"additionalProperties": false
}🟢get_fix(id, paymentTx, paymentOffer)
Get or redeem a fix after search_fixes or list_catalog identifies the id. Free samples return immediately. For a paid fix, call with the id alone to receive a free diagnosis preview, confidence and compatibility, dollar price, signed Base Pay USDC and exact-ETH offers, and one pay-and-redeem action; then call once more with the matching paymentTx and private paymentOffer. Never pay again merely because an existing proof is pending or denied.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Fix id from search_fixes or list_catalog"
},
"paymentTx": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Base Pay UserOperation hash for USDC or Base transaction hash for ETH; omit for free samples."
},
"paymentOffer": {
"type": "string",
"maxLength": 2048,
"description": "Private signed bearer token from search_fixes or get_offer; omit for free samples and never publish it."
}
},
"required": [
"id"
]
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"denied": {
"type": "array",
"items": {
"type": "string"
}
},
"fixId": {
"type": "string"
},
"purchase": {
"type": "object",
"properties": {
"checkout": {
"type": "string",
"enum": [
"ready",
"unavailable"
],
"description": "Whether both signed payment rails were issued."
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"confidence": {
"type": "string"
},
"compatibility": {
"type": "object",
"additionalProperties": true
},
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"relatedBundle": {
"type": "object",
"additionalProperties": true
},
"recommendation": {
"type": "object",
"description": "Demand evidence and matched-fix context when a multi-fix pack is the recommended purchase.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
}
},
"required": [
"checkout",
"price",
"nextAction"
],
"additionalProperties": true
},
"nextAction": {
"type": "object",
"additionalProperties": true
},
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"tier": {
"type": "string"
},
"cause": {
"type": "string"
},
"fix": {
"type": "object",
"additionalProperties": true
},
"receipt": {
"type": "object",
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"properties": {
"spec": {
"type": "string",
"enum": [
"knownfix-payment-receipt/1.0"
]
},
"scheme": {
"type": "string",
"enum": [
"base-pay-usdc",
"base-exact-eth"
]
},
"custody_model": {
"type": "string",
"enum": [
"direct-settlement"
]
},
"reversal_supported": {
"type": "boolean",
"const": false
},
"lifecycle": {
"type": "object",
"properties": {
"authorization": {
"type": "string",
"enum": [
"offer-verified"
]
},
"settlement": {
"type": "string",
"enum": [
"confirmed"
]
},
"fulfillment": {
"type": "string",
"enum": [
"pending",
"released",
"declined"
]
}
},
"required": [
"authorization",
"settlement",
"fulfillment"
],
"additionalProperties": false
},
"proof": {
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base-mainnet"
]
},
"chain_id": {
"type": "integer",
"const": 8453
},
"type": {
"type": "string",
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
]
}
},
"required": [
"network",
"chain_id",
"type"
],
"additionalProperties": false
}
},
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}🟡get_skill(id, paymentTx, paymentOffer)
Get or redeem a premium skill or multi-fix bundle after choosing with list_skills. Call with the id alone to receive the free outline, dollar price, signed Base Pay USDC and exact-ETH offers, and one pay-and-redeem action. After payment, call once more with the matching paymentTx and private paymentOffer for the complete SKILL.md or assembled bundle decision tree, fix bodies, verification commands, update guidance, and sources. Do not use this for individual fixes; call get_fix instead. Never pay again merely because an existing proof is pending or denied.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Exact skill or bundle id from list_skills."
},
"paymentTx": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Base Pay UserOperation hash for USDC or Base transaction hash for ETH."
},
"paymentOffer": {
"type": "string",
"maxLength": 2048,
"description": "Private signed bearer token from get_offer; never publish it."
}
},
"required": [
"id"
]
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"denied": {
"type": "array",
"items": {
"type": "string"
}
},
"purchase": {
"type": "object",
"properties": {
"checkout": {
"type": "string",
"enum": [
"ready",
"unavailable"
],
"description": "Whether both signed payment rails were issued."
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"confidence": {
"type": "string"
},
"compatibility": {
"type": "object",
"additionalProperties": true
},
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"relatedBundle": {
"type": "object",
"additionalProperties": true
},
"recommendation": {
"type": "object",
"description": "Demand evidence and matched-fix context when a multi-fix pack is the recommended purchase.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
}
},
"required": [
"checkout",
"price",
"nextAction"
],
"additionalProperties": true
},
"nextAction": {
"type": "object",
"additionalProperties": true
},
"priceWei": {
"type": "string"
},
"priceUsd": {
"type": "string"
},
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"format": {
"type": "string"
},
"skillMd": {
"type": "string",
"description": "Full assembled Markdown. Bundles include their decision tree, included fix bodies, commands, verification guidance, and sources."
},
"soldTo": {
"type": "string"
},
"via": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"properties": {
"spec": {
"type": "string",
"enum": [
"knownfix-payment-receipt/1.0"
]
},
"scheme": {
"type": "string",
"enum": [
"base-pay-usdc",
"base-exact-eth"
]
},
"custody_model": {
"type": "string",
"enum": [
"direct-settlement"
]
},
"reversal_supported": {
"type": "boolean",
"const": false
},
"lifecycle": {
"type": "object",
"properties": {
"authorization": {
"type": "string",
"enum": [
"offer-verified"
]
},
"settlement": {
"type": "string",
"enum": [
"confirmed"
]
},
"fulfillment": {
"type": "string",
"enum": [
"pending",
"released",
"declined"
]
}
},
"required": [
"authorization",
"settlement",
"fulfillment"
],
"additionalProperties": false
},
"proof": {
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base-mainnet"
]
},
"chain_id": {
"type": "integer",
"const": 8453
},
"type": {
"type": "string",
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
]
}
},
"required": [
"network",
"chain_id",
"type"
],
"additionalProperties": false
}
},
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"description": "KnownFix source attribution request returned with the purchased good.",
"additionalProperties": true
}
},
"additionalProperties": true
}🟡submit_fix(title, signature, cause, fix, reproduction, ...)
Offer a fix for the catalog. Submissions are reviewed by the operator before listing; include a reproduction so the fix can be verified rather than trusted. Returns a private submissionId; save it and call check_submission for pending, accepted, declined, or cataloged status. Submitted text and contributor details are never returned by the status tool. Revenue-sharing for accepted contributions is planned, not yet live.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Short, specific failure-and-recovery name; do not use a generic category.",
"maxLength": 160
},
"signature": {
"type": "string",
"description": "Exact error text an agent would search, including the code and distinctive tokens; omit secrets and private paths.",
"maxLength": 2000
},
"cause": {
"type": "string",
"description": "Root cause supported by the reproduction, without secrets or private paths.",
"maxLength": 4000
},
"fix": {
"type": "string",
"description": "Concrete remediation steps and commands, sanitized of credentials.",
"maxLength": 8000
},
"reproduction": {
"type": "string",
"description": "Minimal steps that reproduce the failure, followed by commands or checks proving the remediation works; omit credentials and private infrastructure.",
"maxLength": 8000
},
"contributor": {
"type": "string",
"description": "Optional private credit/contact string (name, public URL, or wallet). Stored for review; never returned by check_submission.",
"maxLength": 500
}
},
"required": [
"title",
"signature",
"fix"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"detail": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"received"
]
},
"submissionId": {
"type": "string",
"format": "uuid",
"description": "Private lookup id returned once to the submitter."
},
"nextAction": {
"type": "string"
}
},
"additionalProperties": false
}🟢check_submission(submissionId)
Check the private submissionId returned by submit_fix. Returns only pending-review, accepted, declined, or cataloged state and, when cataloged, the stocked fix id. It never returns submitted text or contributor details and creates no side effects. Use get_fix with catalogId when cataloged; do not resubmit merely because review is pending.
Input Schema
{
"type": "object",
"properties": {
"submissionId": {
"type": "string",
"format": "uuid",
"description": "Private UUID returned once by submit_fix. Reuse it unchanged and never publish it; it identifies the review record but cannot retrieve submitted text."
}
},
"required": [
"submissionId"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"detail": {
"type": "string"
},
"submissionId": {
"type": "string",
"format": "uuid"
},
"status": {
"type": "string",
"enum": [
"pending-review",
"accepted",
"declined",
"cataloged"
]
},
"receivedAt": {
"type": "string",
"format": "date-time"
},
"catalogId": {
"type": "string",
"description": "Present when the submitted signature is now stocked."
},
"nextAction": {
"type": "string"
}
},
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded17 tools
verifiedversion not recorded17 tools
verifiedversion not recorded17 tools