KnownFix MCP
KnownFix provides a catalog of developer error fixes, free tools, and scoped technical services for AI agents. It allows agents to diagnose issues, search for exact-error fixes, browse free skills, and request scoped repository or website work via a live tool registry.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://knownfix-backend-28.b-hash88.deno.net/mcpWhat its tools do
19 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (10)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Diagnose agent-readiness issues
- Search for exact-error fixes
- Browse free developer tools and skills
- Request scoped repository audits
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- knownfix 0.6.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 19 advertised
- Resources
- 25 advertised
- Resource templates
- 0 advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
19 advertised
get_free_skill — Read a complete free workflow
Return the complete Markdown body of one free workflow listed by get_overview. No account, payment, paid body or private data. Use list_skills/get_skill for premium products instead. This tool supports clients that cannot read MCP resources.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"enum": [
"evidence-first-bug-report",
"release-smoke-check",
"mcp-connection-triage",
"website-search-readiness",
"api-response-triage",
"webhook-delivery-triage"
],
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id",
"title",
"body",
"resource"
],
"properties": {
"id": {
"type": "string"
},
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"resource": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_overview — Start here: KnownFix tools, guides and services
One free overview of all KnownFix offerings: complete free-workflow resource URIs, three browser-local tools and their companion guides, catalog routes, premium outlines and service prices/scopes/ordering boundaries. No account, payment, signed offer or order creation. Use search_fixes first for an exact error; list_services for full engagement terms.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"spec",
"store",
"inventory",
"freeWorkflows",
"browserTools",
"services"
],
"properties": {
"spec": {
"type": "string"
},
"store": {
"type": "string"
},
"services": {
"type": "array",
"items": {
"type": "object"
}
},
"inventory": {
"type": "object"
},
"browserTools": {
"type": "array",
"items": {
"type": "object"
}
},
"freeWorkflows": {
"type": "array",
"items": {
"type": "object"
}
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_fixes — Search verified fixes
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.
{
"type": "object",
"required": [
"query"
],
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"query",
"matches"
],
"properties": {
"fix": {
"type": "object",
"description": "Full fix, present only when the top match is free.",
"additionalProperties": true
},
"miss": {
"type": "boolean"
},
"query": {
"type": "string",
"description": "The exact query that was evaluated."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"signature",
"confidence",
"match"
],
"properties": {
"id": {
"type": "string"
},
"match": {
"type": "number"
},
"title": {
"type": "string"
},
"sample": {
"type": "boolean"
},
"signature": {
"type": "string"
},
"confidence": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Confident ranked matches; empty means KnownFix is not claiming a match."
},
"purchase": {
"type": "object",
"required": [
"checkout",
"price",
"nextAction"
],
"properties": {
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"checkout": {
"enum": [
"ready",
"unavailable"
],
"type": "string",
"description": "Whether both signed payment rails were issued."
},
"confidence": {
"type": "string"
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
},
"compatibility": {
"type": "object",
"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
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
}
},
"description": "Purchase-ready diagnosis, signed offers, payment rails, and the single next action for a paid top match.",
"additionalProperties": true
},
"topMatchTier": {
"enum": [
"free-sample",
"paid"
],
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}request_fix — Request a missing fix
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.
{
"type": "object",
"required": [
"signature"
],
"properties": {
"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)"
},
"signature": {
"type": "string",
"description": "The exact error text you are stuck on"
}
}
}{
"type": "object",
"properties": {
"note": {
"type": "string",
"description": "Required next step and ticket handling guidance."
},
"error": {
"type": "string",
"description": "Machine-readable validation or quota failure."
},
"fixId": {
"type": "string",
"description": "Existing catalog id when no ticket was needed."
},
"match": {
"type": "number",
"description": "Existing-fix match score."
},
"detail": {
"type": "string",
"description": "Human-readable failure detail."
},
"status": {
"enum": [
"already-stocked",
"recorded"
],
"type": "string"
},
"ticket": {
"type": "string",
"pattern": "^req_[0-9a-f]{32}$"
},
"published": {
"type": "boolean"
},
"requestId": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}check_request — Check a fix request
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.
{
"type": "object",
"required": [
"ticket"
],
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"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."
},
"error": {
"type": "string",
"description": "Machine-readable ticket or fulfillment failure."
},
"fixId": {
"type": "string"
},
"detail": {
"type": "string",
"description": "Human-readable failure or eligibility detail."
},
"reason": {
"type": "string"
},
"status": {
"enum": [
"pending",
"declined",
"not-eligible",
"stocked",
"redeemed"
],
"type": "string"
},
"requestId": {
"type": "string",
"format": "uuid"
},
"receivedAt": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_catalog — List the fix 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.
{
"type": "object",
"properties": {}
}{
"type": "object",
"required": [
"spec",
"store",
"tier",
"entries"
],
"properties": {
"spec": {
"type": "string"
},
"tier": {
"type": "string"
},
"store": {
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"tagline": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_skills — List premium skills and bundles
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.
{
"type": "object",
"properties": {}
}{
"type": "object",
"required": [
"spec",
"tier",
"howToBuy",
"skills"
],
"properties": {
"spec": {
"type": "string"
},
"tier": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"howToBuy": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_merch — List Merch Store products
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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"spec",
"store",
"storefront",
"fulfilledBy",
"checkout",
"privacy",
"products"
],
"properties": {
"spec": {
"type": "string"
},
"store": {
"type": "string"
},
"privacy": {
"type": "string"
},
"checkout": {
"type": "string"
},
"products": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"storefront": {
"type": "string",
"format": "uri"
},
"fulfilledBy": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_services — List professional services
Compare all current KnownFix reviews, Verified Repo Fix and Microsite Launch. Returns complete scope, deliverables, prices, delivery targets and limitations. Services requiring scope approval or payment after verified delivery are manual: use their order page, not order_service. SaaS security requires explicit written testing authorization. Other services use private-ticket checkout only after operator spending approval and target authorization.
{
"type": "object",
"properties": {}
}{
"type": "object",
"required": [
"spec",
"currency",
"privacy",
"services"
],
"properties": {
"spec": {
"type": "string"
},
"privacy": {
"type": "string"
},
"currency": {
"type": "string"
},
"services": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}order_service — Create a private professional-service order
Create a private ticket and signed Base USDC/ETH checkout for an eligible automated service only. Do not call for requiresScopeApproval services (SaaS security, Microsite Launch) or paymentTiming:after-verified-delivery (Verified Repo Fix); these require manual scope approval via their published page. Accepts authorized public HTTPS targets only. Obtain operator spending approval. Never send credentials or confidential data. Keep the returned svc_ ticket private.
{
"type": "object",
"required": [
"serviceId",
"targetUrl",
"authorizationConfirmed"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 1500,
"description": "Optional review focus. Never include credentials, tokens, secrets, private URLs, or confidential data."
},
"serviceId": {
"enum": [
"microsite-launch",
"website-first-look",
"website-growth-audit",
"homepage-build",
"codebase-review",
"agent-commerce-audit",
"release-pipeline-review",
"webhook-reliability-review",
"saas-security-exposure-review"
],
"type": "string"
},
"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."
},
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"status": {
"type": "string"
},
"ticket": {
"type": "string"
},
"service": {
"type": "object",
"additionalProperties": true
},
"purchase": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}check_service_order — Confirm payment or retrieve a service report
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.
{
"type": "object",
"required": [
"ticket"
],
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"spec": {
"type": "string"
},
"status": {
"type": "string"
},
"receipt": {
"type": "object",
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"properties": {
"spec": {
"enum": [
"knownfix-payment-receipt/1.0"
],
"type": "string"
},
"proof": {
"type": "object",
"required": [
"network",
"chain_id",
"type"
],
"properties": {
"type": {
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
],
"type": "string"
},
"network": {
"enum": [
"base-mainnet"
],
"type": "string"
},
"chain_id": {
"type": "integer",
"const": 8453
}
},
"additionalProperties": false
},
"scheme": {
"enum": [
"base-pay-usdc",
"base-exact-eth"
],
"type": "string"
},
"lifecycle": {
"type": "object",
"required": [
"authorization",
"settlement",
"fulfillment"
],
"properties": {
"settlement": {
"enum": [
"confirmed"
],
"type": "string"
},
"fulfillment": {
"enum": [
"pending",
"released",
"declined"
],
"type": "string"
},
"authorization": {
"enum": [
"offer-verified"
],
"type": "string"
}
},
"additionalProperties": false
},
"custody_model": {
"enum": [
"direct-settlement"
],
"type": "string"
},
"reversal_supported": {
"type": "boolean",
"const": false
}
},
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"additionalProperties": false
},
"service": {
"type": "object",
"additionalProperties": true
},
"reportSha256": {
"type": "string"
},
"reportMarkdown": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}audit_endpoint — Audit an agent endpoint
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.
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Base URL to audit, e.g. https://your-agent.example.com"
},
"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)"
}
}
}{
"type": "object",
"properties": {
"via": {
"type": "string"
},
"tier": {
"enum": [
"free-grade",
"full-report"
],
"type": "string"
},
"error": {
"type": "string",
"description": "Machine-readable failure code."
},
"grade": {
"type": "string",
"description": "Overall readiness grade."
},
"checks": {
"type": "array",
"items": {
"type": "object",
"required": [
"check",
"status"
],
"properties": {
"check": {
"type": "string"
},
"detail": {
"type": "string",
"description": "Paid report finding; omitted from the free grade."
},
"status": {
"enum": [
"pass",
"warn",
"fail",
"na"
],
"type": "string"
},
"remediation": {
"type": "string",
"description": "Paid remediation; omitted from the free grade."
}
},
"additionalProperties": false
}
},
"soldTo": {
"type": "string"
},
"target": {
"type": "string",
"description": "Canonical URL that was audited."
},
"receipt": {
"type": "object",
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"properties": {
"spec": {
"enum": [
"knownfix-payment-receipt/1.0"
],
"type": "string"
},
"proof": {
"type": "object",
"required": [
"network",
"chain_id",
"type"
],
"properties": {
"type": {
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
],
"type": "string"
},
"network": {
"enum": [
"base-mainnet"
],
"type": "string"
},
"chain_id": {
"type": "integer",
"const": 8453
}
},
"additionalProperties": false
},
"scheme": {
"enum": [
"base-pay-usdc",
"base-exact-eth"
],
"type": "string"
},
"lifecycle": {
"type": "object",
"required": [
"authorization",
"settlement",
"fulfillment"
],
"properties": {
"settlement": {
"enum": [
"confirmed"
],
"type": "string"
},
"fulfillment": {
"enum": [
"pending",
"released",
"declined"
],
"type": "string"
},
"authorization": {
"enum": [
"offer-verified"
],
"type": "string"
}
},
"additionalProperties": false
},
"custody_model": {
"enum": [
"direct-settlement"
],
"type": "string"
},
"reversal_supported": {
"type": "boolean",
"const": false
}
},
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"additionalProperties": false
},
"summary": {
"type": "object",
"additionalProperties": true
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"paidReport": {
"type": "object",
"description": "Purchase instructions included with an unpaid report.",
"additionalProperties": true
},
"paymentDeclined": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}audit_theme — Audit page themes and contrast
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.
{
"type": "object",
"required": [
"url"
],
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"note": {
"type": "string",
"description": "Audit coverage and inline-style limitation."
},
"spec": {
"enum": [
"knownfix-theme-audit/0.1"
],
"type": "string"
},
"error": {
"type": "string",
"description": "Machine-readable target or fetch failure."
},
"grade": {
"enum": [
"ready",
"mostly-ready",
"needs-work"
],
"type": "string",
"description": "Overall grade derived from the check counts."
},
"checks": {
"type": "array",
"items": {
"type": "object",
"required": [
"check",
"status",
"detail"
],
"properties": {
"check": {
"type": "string"
},
"detail": {
"type": "string"
},
"status": {
"enum": [
"pass",
"warn",
"fail",
"na"
],
"type": "string"
},
"remediation": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Every inline-CSS theme, token, background, and contrast finding."
},
"detail": {
"type": "string",
"description": "Fetch failure detail."
},
"reason": {
"type": "string",
"description": "Why the target URL was rejected."
},
"target": {
"type": "string",
"format": "uri",
"description": "Canonical page URL inspected."
},
"summary": {
"type": "object",
"required": [
"pass",
"warn",
"fail",
"na"
],
"properties": {
"na": {
"type": "integer",
"minimum": 0
},
"fail": {
"type": "integer",
"minimum": 0
},
"pass": {
"type": "integer",
"minimum": 0
},
"warn": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"checkedAt": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_offer — Create a signed purchase offer
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.
{
"type": "object",
"properties": {
"currency": {
"enum": [
"USDC",
"ETH"
],
"type": "string",
"description": "Settlement rail. Defaults to ETH for backward compatibility."
},
"productId": {
"type": "string",
"description": "Exact fix, skill, bundle, or audit product id."
},
"productType": {
"enum": [
"fix",
"skill",
"audit",
"service"
],
"type": "string",
"description": "Catalog shelf that owns the product id; bundles use skill."
}
}
}{
"type": "object",
"properties": {
"rule": {
"type": "string"
},
"spec": {
"type": "string",
"description": "Offer or settlement-document specification."
},
"error": {
"type": "string",
"description": "Machine-readable product, currency, or checkout failure."
},
"offer": {
"type": "object",
"additionalProperties": true
},
"payTo": {
"type": "string"
},
"token": {
"type": "string",
"description": "Private signed bearer purchase credential; never publish it."
},
"detail": {
"type": "string",
"description": "Human-readable failure detail."
},
"backend": {
"type": "object",
"additionalProperties": true
},
"basePay": {
"type": "object",
"additionalProperties": true
},
"catalog": {
"type": "string",
"format": "uri"
},
"chainId": {
"type": "integer"
},
"network": {
"type": "string"
},
"currency": {
"enum": [
"USDC",
"ETH"
],
"type": "string"
},
"decimals": {
"type": "integer"
},
"priceEth": {
"type": "string"
},
"priceUsd": {
"type": "string"
},
"priceWei": {
"type": "string"
},
"servedBy": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"productId": {
"type": "string"
},
"amountUsdc": {
"type": "string"
},
"paymentUri": {
"type": "string"
},
"redemption": {
"type": "object",
"additionalProperties": true
},
"settlement": {
"type": "object",
"additionalProperties": true
},
"productType": {
"enum": [
"fix",
"skill",
"audit",
"service"
],
"type": "string"
},
"basePriceWei": {
"type": "string"
},
"usdcContract": {
"type": "string"
},
"tokenHandling": {
"type": "string"
},
"amountUsdcAtomic": {
"type": "string"
},
"baseAmountUsdcAtomic": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_checkout_blocker — Report a checkout 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.
{
"type": "object",
"required": [
"productType",
"productId",
"paymentOffer",
"blocker"
],
"properties": {
"blocker": {
"enum": [
"no-compatible-wallet",
"funding-unavailable",
"insufficient-balance",
"base-pay-unavailable",
"payment-rejected",
"payment-failed"
],
"type": "string",
"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."
},
"productId": {
"type": "string",
"maxLength": 120,
"description": "Exact product id encoded in the signed offer."
},
"productType": {
"enum": [
"fix",
"skill",
"audit",
"service"
],
"type": "string",
"description": "Product shelf 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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"rail": {
"enum": [
"USDC",
"ETH"
],
"type": "string"
},
"error": {
"type": "string",
"description": "Machine-readable validation failure."
},
"detail": {
"type": "string",
"description": "Safe failure detail."
},
"status": {
"enum": [
"recorded",
"already-recorded",
"operator-test"
],
"type": "string"
},
"blocker": {
"enum": [
"no-compatible-wallet",
"funding-unavailable",
"insufficient-balance",
"base-pay-unavailable",
"payment-rejected",
"payment-failed"
],
"type": "string"
},
"privacy": {
"type": "string"
},
"nextAction": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_fix — Redeem a fix
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.
{
"type": "object",
"required": [
"id"
],
"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."
}
}
}{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"fix": {
"type": "object",
"additionalProperties": true
},
"tier": {
"type": "string"
},
"cause": {
"type": "string"
},
"error": {
"type": "string"
},
"fixId": {
"type": "string"
},
"title": {
"type": "string"
},
"denied": {
"type": "array",
"items": {
"type": "string"
}
},
"receipt": {
"type": "object",
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"properties": {
"spec": {
"enum": [
"knownfix-payment-receipt/1.0"
],
"type": "string"
},
"proof": {
"type": "object",
"required": [
"network",
"chain_id",
"type"
],
"properties": {
"type": {
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
],
"type": "string"
},
"network": {
"enum": [
"base-mainnet"
],
"type": "string"
},
"chain_id": {
"type": "integer",
"const": 8453
}
},
"additionalProperties": false
},
"scheme": {
"enum": [
"base-pay-usdc",
"base-exact-eth"
],
"type": "string"
},
"lifecycle": {
"type": "object",
"required": [
"authorization",
"settlement",
"fulfillment"
],
"properties": {
"settlement": {
"enum": [
"confirmed"
],
"type": "string"
},
"fulfillment": {
"enum": [
"pending",
"released",
"declined"
],
"type": "string"
},
"authorization": {
"enum": [
"offer-verified"
],
"type": "string"
}
},
"additionalProperties": false
},
"custody_model": {
"enum": [
"direct-settlement"
],
"type": "string"
},
"reversal_supported": {
"type": "boolean",
"const": false
}
},
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"additionalProperties": false
},
"citation": {
"type": "object",
"additionalProperties": true
},
"purchase": {
"type": "object",
"required": [
"checkout",
"price",
"nextAction"
],
"properties": {
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"checkout": {
"enum": [
"ready",
"unavailable"
],
"type": "string",
"description": "Whether both signed payment rails were issued."
},
"confidence": {
"type": "string"
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
},
"compatibility": {
"type": "object",
"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
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"nextAction": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}get_skill — Redeem a premium skill or bundle
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.
{
"type": "object",
"required": [
"id"
],
"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."
}
}
}{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"via": {
"type": "string"
},
"error": {
"type": "string"
},
"title": {
"type": "string"
},
"denied": {
"type": "array",
"items": {
"type": "string"
}
},
"format": {
"type": "string"
},
"soldTo": {
"type": "string"
},
"receipt": {
"type": "object",
"required": [
"spec",
"scheme",
"custody_model",
"reversal_supported",
"lifecycle",
"proof"
],
"properties": {
"spec": {
"enum": [
"knownfix-payment-receipt/1.0"
],
"type": "string"
},
"proof": {
"type": "object",
"required": [
"network",
"chain_id",
"type"
],
"properties": {
"type": {
"enum": [
"erc-4337-user-operation-hash",
"transaction-hash"
],
"type": "string"
},
"network": {
"enum": [
"base-mainnet"
],
"type": "string"
},
"chain_id": {
"type": "integer",
"const": 8453
}
},
"additionalProperties": false
},
"scheme": {
"enum": [
"base-pay-usdc",
"base-exact-eth"
],
"type": "string"
},
"lifecycle": {
"type": "object",
"required": [
"authorization",
"settlement",
"fulfillment"
],
"properties": {
"settlement": {
"enum": [
"confirmed"
],
"type": "string"
},
"fulfillment": {
"enum": [
"pending",
"released",
"declined"
],
"type": "string"
},
"authorization": {
"enum": [
"offer-verified"
],
"type": "string"
}
},
"additionalProperties": false
},
"custody_model": {
"enum": [
"direct-settlement"
],
"type": "string"
},
"reversal_supported": {
"type": "boolean",
"const": false
}
},
"description": "Machine-readable receipt derived by KnownFix after signed-offer and Base proof verification; never accepted from caller input.",
"additionalProperties": false
},
"skillMd": {
"type": "string",
"description": "Full assembled Markdown. Bundles include their decision tree, included fix bodies, commands, verification guidance, and sources."
},
"citation": {
"type": "object",
"description": "KnownFix source attribution request returned with the purchased good.",
"additionalProperties": true
},
"priceUsd": {
"type": "string"
},
"priceWei": {
"type": "string"
},
"purchase": {
"type": "object",
"required": [
"checkout",
"price",
"nextAction"
],
"properties": {
"price": {
"type": "object",
"description": "Dollar-denominated price presented before payment.",
"additionalProperties": true
},
"payment": {
"type": "object",
"description": "Preferred Base Pay parameters and signed exact-ETH alternative.",
"additionalProperties": true
},
"product": {
"type": "object",
"description": "Free skill or bundle outline and product identity.",
"additionalProperties": true
},
"checkout": {
"enum": [
"ready",
"unavailable"
],
"type": "string",
"description": "Whether both signed payment rails were issued."
},
"confidence": {
"type": "string"
},
"nextAction": {
"type": "object",
"description": "The single recommended payment or retry action.",
"additionalProperties": true
},
"compatibility": {
"type": "object",
"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
},
"diagnosisPreview": {
"type": "object",
"description": "Free diagnosis and triage for an individual paid fix.",
"additionalProperties": true
},
"signedPurchaseOffer": {
"type": "object",
"description": "Private product-bound Base Pay USDC offer.",
"additionalProperties": true
},
"singleFixAlternative": {
"type": "object",
"description": "Lower-cost individual-fix fallback when the recommended product is a bundle.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"nextAction": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}submit_fix — Submit a fix for review
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.
{
"type": "object",
"required": [
"title",
"signature",
"fix"
],
"properties": {
"fix": {
"type": "string",
"maxLength": 8000,
"description": "Concrete remediation steps and commands, sanitized of credentials."
},
"cause": {
"type": "string",
"maxLength": 4000,
"description": "Root cause supported by the reproduction, without secrets or private paths."
},
"title": {
"type": "string",
"maxLength": 160,
"description": "Short, specific failure-and-recovery name; do not use a generic category."
},
"signature": {
"type": "string",
"maxLength": 2000,
"description": "Exact error text an agent would search, including the code and distinctive tokens; omit secrets and private paths."
},
"contributor": {
"type": "string",
"maxLength": 500,
"description": "Optional private credit/contact string (name, public URL, or wallet). Stored for review; never returned by check_submission."
},
"reproduction": {
"type": "string",
"maxLength": 8000,
"description": "Minimal steps that reproduce the failure, followed by commands or checks proving the remediation works; omit credentials and private infrastructure."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"detail": {
"type": "string"
},
"status": {
"enum": [
"received"
],
"type": "string"
},
"nextAction": {
"type": "string"
},
"submissionId": {
"type": "string",
"format": "uuid",
"description": "Private lookup id returned once to the submitter."
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}check_submission — Check a fix submission
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.
{
"type": "object",
"required": [
"submissionId"
],
"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."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"detail": {
"type": "string"
},
"status": {
"enum": [
"pending-review",
"accepted",
"declined",
"cataloged"
],
"type": "string"
},
"catalogId": {
"type": "string",
"description": "Present when the submitted signature is now stocked."
},
"nextAction": {
"type": "string"
},
"receivedAt": {
"type": "string",
"format": "date-time"
},
"submissionId": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
25 advertised
Start here: tools, guides, skills and services
One free map of KnownFix, with complete free-workflow resource URIs, browser tools, companion guides and service ordering boundaries. No paid bodies or private statistics.
knownfix://overviewFix catalog
Every error signature this store stocks (40), with which are free in full. Signatures are public so you can confirm a match before paying.
knownfix://catalogSkill outlines
Outline, provenance and price for each of the 11 purchasable skills. Bodies are paid.
knownfix://skillsMost wanted
Fixes agents asked for that this store does not stock yet.
knownfix://requestsProfessional services
Scope, deliverables, price and private order flow for 10 website, homepage-build, code, and agent-commerce services.
knownfix://servicesEvidence-First Bug Report
Turn a suspected website or code defect into a reproducible report, without inventing impact or exposing secrets.
knownfix://free-skill/evidence-first-bug-reportRelease Smoke Check for Codex and Claude
A bounded pre-release and live read-back checklist for developer tools, with honest payment and rollback gates.
knownfix://free-skill/release-smoke-checkMCP Connection Triage
Separate transport, authentication and tool-discovery failures with a minimal, redacted connection receipt.
knownfix://free-skill/mcp-connection-triageWebsite Search Readiness
Review crawl directives, canonical signals and answer clarity without promising rankings or AI citations.
knownfix://free-skill/website-search-readinessAPI Response Triage
Separate HTTP, JSON-RPC and tool-result failures with bounded, evidence-first checks and safe retry decisions.
knownfix://free-skill/api-response-triageWebhook Delivery Triage
Trace missing, failed or duplicate webhooks without replaying live events or confusing delivery with processing.
knownfix://free-skill/webhook-delivery-triageFix __dirname is not defined in ES module scope in Node.js
Free sample, full body. Signature: ReferenceError: __dirname is not defined in ES module scope
knownfix://fix/node-esm-dirname-not-definedFix ERR_UNSUPPORTED_DIR_IMPORT in Node.js ES modules
Free sample, full body. Signature: Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import is not supported resolving ES modules
knownfix://fix/node-esm-unsupported-dir-importOpenZeppelin 5.x fails to compile: Function "mcopy" not found
Free sample, full body. Signature: DeclarationError: Function "mcopy" not found
knownfix://fix/oz5-mcopy-cancunnode --test with a bare directory argument fails with a nameless failing 'test'
Free sample, full body. Signature: test at test:1:1 ... 'test failed' with zero real tests run
knownfix://fix/node-test-dir-arg-windowsProbing a dependency via require('X/package.json') throws ERR_PACKAGE_PATH_NOT_EXPORTED
Free sample, full body. Signature: Package subpath './package.json' is not defined by "exports"
knownfix://fix/err-package-path-not-exported-probegit push to your own private repo fails with 'repository not found'
Free sample, full body. Signature: fatal: repository 'https://github.com/OWNER/REPO.git/' not found
knownfix://fix/gh-cli-account-revert-private-repo-404Deno Deploy returns 508 Loop Detected when a deployment fetches its own URL
Free sample, full body. Signature: 508 (Loop Detected) on fetch to the app's own *.deno.net hostname
knownfix://fix/deno-deploy-508-self-fetch-loopDeno KV reads empty on new Deno Deploy until you attach a database
Free sample, full body. Signature: kv appears disabled / Deno.openKv() bound but reads and writes are empty on console.deno.com
knownfix://fix/deno-deploy-kv-not-auto-enabledDeno.openKv() throws locally without the --unstable-kv flag
Free sample, full body. Signature: Deno.openKv is not a function / requires --unstable-kv (works on Deploy, fails on local deno run)
knownfix://fix/deno-openkv-unstable-flag-localMCP Registry publish fails 422: description exceeds 100 characters
Free sample, full body. Signature: validation failed: expected length <= 100, location body.description
knownfix://fix/mcp-registry-description-100-char-422MCP Registry publish 401: Invalid or expired Registry JWT token
Free sample, full body. Signature: publish failed: server returned status 401 ... token has invalid claims: token is expired
knownfix://fix/mcp-registry-jwt-expired-401Windows: an env var set with setx is missing in the shell that set it
Free sample, full body. Signature: environment variable appears unset immediately after setx reported success
knownfix://fix/windows-setx-not-in-running-shellGitHub Pages serves 404 while the repo and index.html are both intact
Free sample, full body. Signature: {"message":"Not Found","documentation_url":"https://docs.github.com/rest/pages/pages#get-a-apiname-pages-site","status":"404"}
knownfix://fix/gh-pages-disabled-site-404npm exec says the package command is not recognized inside its own source directory
Free sample, full body. Signature: '<command>' is not recognized as an internal or external command, operable program or batch file.
knownfix://fix/npm-exec-local-bin-not-found90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1802 ms
- 95th percentile latency
- 1802 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1802 ms · metadata changed · 19 tool(s), 25 resource(s), 0 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http knownfix-mcp-deno https://knownfix-backend-28.b-hash88.deno.net/mcpCodex
codex mcp add knownfix-mcp-deno --url https://knownfix-backend-28.b-hash88.deno.net/mcpCursor
{
"mcpServers": {
"knownfix-mcp-deno": {
"url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
}
}
}Cline
{
"mcpServers": {
"knownfix-mcp-deno": {
"type": "streamableHttp",
"url": "https://knownfix-backend-28.b-hash88.deno.net/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"knownfix-mcp-deno": {
"type": "http",
"url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http knownfix-mcp-deno https://knownfix-backend-28.b-hash88.deno.net/mcpClaude Desktop
https://knownfix-backend-28.b-hash88.deno.net/mcpWindsurf
{
"mcpServers": {
"knownfix-mcp-deno": {
"serverUrl": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
}
}
}Let your agent find its tools
Find servers like KnownFix MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.