KnownFix

io.github.b-hash88Published by GitHub account b-hash88v0.6.1Updated Oct 27, 2026

Developer fixes, free skills, browser tools and scoped technical services over MCP.

The publisher's own server: Known

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

KnownFix is an agent-facing catalog of development-error fixes, free workflow skills and paid technical services, reachable over MCP.

What you can do
  • Search and browse error fixes, then read free fixes or redeem paid ones with a payment proof
  • List and read free workflow skills, and compare premium skills and bundles
  • Request a fix that is not stocked yet and check the private ticket status
  • Compare scoped services, order eligible automated ones and check their status
  • Audit an agent-facing endpoint or a public page's theme, read-only
  • Submit a fix for review and check the submission status
When to use it
Useful when an assistant hits a specific development error and needs a known fix, or when you want free workflow skills, endpoint or theme audits, or scoped technical reviews ordered through the same server.
Requirements
Works as a remote Streamable HTTP endpoint or as a local npm package over stdio. No account or API key is required. Paid fixes and services need a crypto wallet able to pay on Base mainnet in USDC or ETH. The bundled local CLI commands need Node.js 18 or newer.
Before you install
Paid fixes and services cost real money in USDC or ETH on Base mainnet; offers are one-hour, single-use bearer tokens that must be kept private. Redeeming a paid fix or skill, ordering a service, requesting a fix and submitting a fix all create records or consume tickets, and some calls are one-time. Submitted text and contact details go to the operator for review. Optional site analytics are opt-in.

Installation

In SourceWeft

  1. Open KnownFix in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.b-hash88%2Fknownfix/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "knownfix": {
      "type": "http",
      "url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
    }
  }
}

README

KnownFix

KnownFix is an agent-facing catalog of development-error fixes. The current overview reports inventory and evidence labels; fourteen fixes are available in full for free. Search is free; paid fixes start at $0.05 USDC through Base Pay or a signed exact-ETH equivalent on Base mainnet.

KnownFix offers ten scoped services, including website audits, a homepage build, code and release reviews, a Webhook Reliability Review ($179 USDC / 3 business days), and a SaaS Security Exposure Review ($299 USDC / 5 business days). Verified Repo Fix is $149 USDC / 3 business days from scope acceptance and a complete reproducible brief, with payment only on verified delivery. Microsite Launch is $299 USDC / 5 business days after scope approval, approved content/assets and manual payment before work. SaaS security requires written ownership/testing permission and an agreed target/method/window allowlist before payment or testing; its five-day target begins after approval, payment and required access. These three services use manual scope/payment arrangements, not automated checkout. Other review targets begin after payment and a complete in-scope brief. The service catalog is authoritative.

Three free browser-local tools complement six free workflow skills: MCP Connection Kit, MCP Response Inspector, and Webhook Retry Planner. The planner compares capped backoff and full-jitter timing against a time budget. It sends no webhooks and saves no settings. Optional analytics records fixed action labels only; those events are not unique users or successful deliveries.

Storefront Checks

Website analytics uses GA4 G-PPPE9TYRM2 (property 559407250). The earlier G-781DC76YQN is the Fourthwall shop stream, not the website reporting source. Never merge shop visits or MCP request counters into website visitor totals. The website property reports in America/Vancouver; a UTC test can fall on the previous reporting day. Consent is opt-in, advertising stays denied, and QA events are not customer activity. Report processing is separate from transport.

tests/analytics-property.mjs checks every HTML page and marked action, failing on missing tracking rather than silently skipping new pages. Four deliberate exclusions stay untracked: the ownership-verification file, fictional Patchnote demo and two sample reports. tests/analytics-consent-lifecycle.mjs covers every tracked wrapper. tests/analytics-coverage-browser.mjs loads all tracked pages and exercises homepage actions with Google and backend writes blocked; it uses the installed-Playwright recipe below. tests/tool-guides-browser.mjs verifies the three tools' check, copy, download, calculate, reset and guide actions. The opt-in tests/tool-guides-live-analytics.mjs creates synthetic QA events in temporary profiles only. HTTP204 is transport evidence, not proof of GA4 report receipt; verify the matching main-site property separately. Never alter an owner's saved consent or use a live checkout to test analytics.

Three companion guides live under guides/, with nine fixed synthetic JSON examples, linked from the tools, homepage and free-skills hub. Regenerate this content with node scripts/sync-tool-guides.mjs. The MCP-kit and retry-planner generators also run this sync. node tests/tool-guides.mjs checks reproducible outcomes, links, downloads, analytics boundaries and generator idempotence. tests/tool-guides-browser.mjs uses the same installed-Playwright environment recipe below; KNOWNFIX_BROWSER_CHANNEL=msedge selects an installed Edge. Guide events use guide_action with fixed open-tool, download-example and related-guide contexts. Tool examples reuse the respective tool action event; no pasted input or entered settings enter these events. All require consent.

Run node tests/retry-planner.mjs and node tests/service-comparison.mjs for the new tool and catalog consistency. The existing Gitea workflow includes both. tests/retry-planner-browser.mjs uses the existing KNOWNFIX_PLAYWRIGHT_PATH recipe to resolve an installed Playwright package without downloading one. Set PLAYWRIGHT_BROWSERS_PATH to the installed browser cache when needed and KNOWNFIX_SCREENSHOT_DIR to retain desktop/mobile screenshots. Tests start and close a temporary localhost server and block real backend writes.

Regenerate the planner with node scripts/sync-retry-planner.mjs, then run node scripts/sync-site-improvements.mjs to refresh catalog comparison and links. The service sync also refreshes that comparison after catalog changes.

Connect an agent

Use the client-specific connection kit for Claude Code, Codex, Cursor, VS Code or the Claude Desktop stdio bridge. It includes supported install links and a free first-use example. Configuration, tool discovery and successful workflow retrieval are distinct milestones.

Install the free toolkit

Six standard skills/<name>/SKILL.md directories contain the complete free workflows, synthetic exercises and acceptance criteria. Review them, then use npx skills add b-hash88/knownfix to choose a client and scope interactively, or copy reviewed directories using the client's documented skill installation.

The toolkit also provides dependency-free local commands:

sh
node toolkit/cli.mjs inspect-response toolkit/examples/response.jsonnode toolkit/cli.mjs retry-plan toolkit/examples/retry.json

Node.js 18+, file/stdin JSON, 200,000-byte cap. No network or telemetry during these commands. Envelope structure is not tool success; modeled retries do not send webhooks. Run node scripts/sync-agent-toolkit.mjs after changing skill or browser-core sources, and node tests/agent-toolkit.mjs to verify parity.

Remote endpoint

KnownFix is listed as io.github.b-hash88/knownfix. Its remote Streamable HTTP MCP endpoint is:

text
https://knownfix-backend-28.b-hash88.deno.net/mcp

The live registry exposes search, catalog, signed offers, fix and skill delivery, endpoint audits, submissions, fix requests, professional review ordering and retrieval, and a read-only apparel catalog through list_merch. npx knownfix tools prints the current list instead of relying on copied docs. The branded Smithery directory name is knownfix/knownfix.

For the current npm Trusted Publishing failure, search the exact CLI signature:

bash
npx knownfix search "npm ERR! code EOTP"

KnownFix also matches This operation requires a one-time password from your authenticator. and the npm --otp=<code> wording. The public diagnostic page cites npm's current CLI source; the npm Publishing Recovery Pack contains the six-fix decision tree and verification commands.

Paid delivery

Free fixes return immediately. A paid search_fixes match includes a free diagnosis preview, confidence and compatibility, dollar price, a private signed offer, wallet/payment URI, and one recommended next action. Each one-hour offer is bound to one product, one currency, and one payment intent:

  1. Use the offer returned by search_fixes, or request one directly with MCP get_offer or POST /offer.
  2. Keep the bearer token private. Use the exact Base Pay parameters for USDC or pay exactly priceWei for ETH on chain 8453.
  3. Redeem with paymentTx plus paymentOffer, or the corresponding HTTP headers. For USDC, paymentTx is the returned ERC-4337 UserOperation hash; for ETH, it is the mined transaction hash.

The payment proof and offer are atomically single-use in Deno KV. A public chain hash alone is not accepted as a purchase credential. The store also carries five crawlable recovery packs for npm, GitHub Actions, MCP, Windows agent shells, and Base payment verification.

Honesty contract

verified-in-production means reproduced and fixed in a real session; documented means sourced but not independently reproduced. An unmatched search returns empty. The books distinguish raw requests, MCP polling, real tool calls, deliveries, paid intent, and settled sales.

KnownFix is AI-operated on human-owned hosting, deployment, and treasury infrastructure. No buyer account or API key is required.

Live end-to-end test

Run the dependency-free production suite with Node 20 or newer:

bash
node tests/live-e2e.mjs

The suite crawls every canonical URL and checks the current free/paid page pairs, product packs and service catalog, HTTP and MCP search/delivery/offer flows, distinct UserOperation and transaction proofs, anonymous stats access controls, and security headers. Requests carry x-operator: 1 so delivery and purchase-intent tests do not contaminate those conversion counters. Set KNOWNFIX_SERVICE_ORDER_TARGET to an authorized public URL only when intentionally testing creation of one private operator order; routine runs do not fill the order queue.

Public Discovery And Site Quality

agents.html is the human-readable MCP start page; notes-for-agents.md is its portable counterpart. Start with get_overview / knownfix://overview / backend GET /overview. get_free_skill({id}) supports tool-only clients; resource-capable clients can read each knownfix://free-skill/<id> directly. There are three local browser tools, three guides, six full free workflows, eleven premium workflow outlines and ten scoped services. Manual approval and payment-on-delivery services never use upfront automated orders.

After other storefront generators, run node scripts/sync-site-quality.mjs. The guide and comparison generators invoke this finalizer too. It preserves prices/scopes, aligns payment metadata, maintains fix landmarks/navigation, and applies current-consent/own-property analytics guards. premium-skills.json contains only allowlisted fields from the public backend /skills response, not paid bodies. Refresh that snapshot only after checking current public terms. node tests/site-quality.mjs protects consistency and generator idempotence. scripts/audit-site.mjs uses the same explicitly configured installed Playwright runtime as the browser suites to inspect all public HTML and local links.

Source: README.md at commit 1db1fb8

Tools

19

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.

Parametersidrequired

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.

Takes no parameters.

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.

Parametersqueryrequired

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.

Parameterscontextpublishsignaturerequired

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.

Parametersticketrequired

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.

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

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.

Takes no parameters.

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.

ParametersnotesserviceIdrequiredtargetUrlrequiredpublishTargetauthorizationConfirmedrequired

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.

ParametersticketrequiredpaymentTxpaymentOffer

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.

ParametersurlrequiredpaymentTxpaymentOffer

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.

Parametersurlrequired

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.

ParameterscurrencyproductIdproductType

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.

ParametersblockerrequiredproductIdrequiredproductTyperequiredpaymentOfferrequired

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.

ParametersidrequiredpaymentTxpaymentOffer

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.

ParametersidrequiredpaymentTxpaymentOffer

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.

Parametersfixrequiredcausetitlerequiredsignaturerequiredcontributorreproduction

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.

ParameterssubmissionIdrequired

Version history

3
  1. v0.6.1LatestOct 19, 2026
  2. v0.6.0Oct 19, 2026
  3. v0.5.1Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Known integrations