{"protocolVersion":"2025-06-18","serverInfo":{"name":"fetchwerk","title":"Agent Fetch Hub","version":"1.0.0"},"capabilities":{"tools":{"listChanged":false}},"transport":{"type":"http","endpoint":"https://fetch.halowerk.com/mcp","methods":["POST"]},"payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC","note":"tools/list needs no payment. tools/call settles the tool price over x402."},"tools":[{"name":"extract_url","description":"Fetch one web page and return clean article Markdown with navigation, ads and cookie banners removed. Paid per call in USDC over x402.","inputSchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL to extract."},"format":{"type":"string","enum":["markdown","text","html"],"default":"markdown"},"include_links":{"type":"boolean","default":false,"description":"Return outbound links found in the document."},"include_images":{"type":"boolean","default":false},"max_chars":{"type":"integer","minimum":500,"maximum":400000,"default":200000}}}},{"name":"url_metadata","description":"Return title, description, OpenGraph card, canonical URL, feeds, favicon and detected technologies for one URL. Cheaper than a full extraction.","inputSchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL to extract."}}}},{"name":"extract_structured","description":"Fill your own JSON Schema from one web page. schema.org JSON-LD, microdata and OpenGraph are mapped first, a language model only fills what they left open, and every value must occur verbatim in the document or follow from it by calculation. Returns the filled object plus field_sources and confidence per field, so a caller can tell a documented value from a guessed one. Ungrounded fields stay empty and are listed under unavailable_fields.","inputSchema":{"type":"object","required":["url","schema"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL to read."},"schema":{"type":"object","description":"Target JSON Schema, draft 2020-12. Only the types object, array, string, number, integer, boolean and null are accepted; composition keywords such as $ref, oneOf, anyOf, allOf and if/then are refused. At most 200 fields and no deeper than max_depth. The root must describe an object."},"strict":{"type":"boolean","default":true,"description":"true rejects the call with 422 when the result violates the submitted schema, so no partial data is returned and nothing is charged. false returns the partial data with the error list."},"max_depth":{"type":"integer","minimum":1,"maximum":4,"default":3,"description":"Maximum nesting depth the submitted schema may use. A deeper schema is refused before payment."}}},"outputSchema":{"type":"object","properties":{"url":{"type":"string"},"data":{"type":"object","description":"The filled schema."},"validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"object"}}}},"field_sources":{"type":"object","description":"Per field path one of jsonld, microdata, dom or model. A field that is absent here carries no value.","additionalProperties":{"type":"string","enum":["jsonld","microdata","dom","model"]}},"confidence":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":1}},"unavailable_fields":{"type":"array","items":{"type":"string"}},"fetched_at":{"type":"string","format":"date-time"},"cached":{"type":"boolean"},"charged":{"type":"boolean"}}}},{"name":"page_diff","description":"Report what actually changed on a page. Timestamps, counters, session and CSRF values, ads, cookie notices, navigation, footers, shuffled ordering, cache busting parameters and rotating image filenames are removed on both sides first; text, prices, availability, headings, link targets, structured data, form fields and meta remain. Compares against the state fetchwerk stored for the URL, or against two documents you supply. A first call for an unknown URL only stores the baseline and costs 0.001 USDC instead of 0.003. No changes found is a valid paid answer.","inputSchema":{"type":"object","description":"Either \"url\" (compare against the state fetchwerk stored for it) or \"before\" and \"after\" (compare two supplied documents).","properties":{"url":{"type":"string","format":"uri","description":"Page to fetch and compare against its last stored state."},"since":{"type":"string","format":"date-time","description":"ISO timestamp. Picks the stored state at or before this moment instead of the newest one."},"before":{"type":"string","description":"Earlier document as HTML or Markdown. No network access is used."},"after":{"type":"string","description":"Later document as HTML or Markdown."},"before_fetched_at":{"type":"string","format":"date-time","description":"Optional, echoed back for inline comparisons."},"after_fetched_at":{"type":"string","format":"date-time","description":"Optional, echoed back for inline comparisons."}},"anyOf":[{"required":["url"]},{"required":["before","after"]}]}},{"name":"extract_batch","description":"Extract up to ten URLs in a single paid call. Failures are reported per item.","inputSchema":{"type":"object","required":["urls"],"properties":{"urls":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","format":"uri"}},"format":{"type":"string","enum":["markdown","text","html"],"default":"markdown"},"max_chars":{"type":"integer","minimum":500,"maximum":400000,"default":200000}}}},{"name":"extract_product","description":"Read one product page and return the structured offer: name, brand, SKU, MPN, GTIN, ASIN, price with currency and raw string, list price, discount, price per unit and German PAngV base price, availability with quantity, shipping costs, delivery time, carrier and pickup, variants with their own price and GTIN, ratings, images and seller. Every field names its source in field_evidence. Prices are parsed, never calculated or converted. A page that is not a product page answers is_product=false with a reason.","inputSchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL of a single product page."},"currency_hint":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO 4217 code such as EUR or USD. Used to disambiguate the $ and kr symbols and the decimal separator. It never triggers a conversion."},"want_variants":{"type":"boolean","default":true,"description":"Collect size, colour and other variants with their own price, availability, GTIN and URL."}}}}]}