{"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, identifiers, price, availability, shipping, variants, ratings, images and seller. Sources include JSON-LD, microdata, OpenGraph, embedded application state, rendered DOM and visible text; marketplace item and shop ids are retained. Every value names its source. Payment is settled only when a useful offer is delivered. Empty classifications, blocked pages and insufficient application shells return an uncharged error with the partial result.","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."}}}},{"name":"compare_products","description":"Compare two to four product pages with the same evidence-grounded extractor. Returns exact identifier matches, the lowest stated price per currency, availability, shipping-cost and rating leaders. Currencies are never converted and no same-product claim is made without a shared GTIN, ASIN, MPN, SKU or manufacturer part number. Fewer than two usable offers fail without charge.","inputSchema":{"type":"object","required":["urls"],"additionalProperties":false,"properties":{"urls":{"type":"array","minItems":2,"maxItems":4,"uniqueItems":true,"items":{"type":"string","format":"uri"},"description":"Two to four distinct product-page URLs. At least two must yield a useful product offer or the call is not charged."},"currency_hint":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO 4217 code used only to disambiguate symbols and decimal notation. No currency conversion is performed."},"want_variants":{"type":"boolean","default":false,"description":"Also collect each page’s variants. The ranking still compares the primary listed offer."},"respect_robots":{"type":"boolean","default":true,"description":"Honour every origin robots.txt."}}},"outputSchema":{"type":"object","required":["requested","compared","products","comparison","methodology","fetched_at"],"properties":{"requested":{"type":"integer","minimum":2,"maximum":4},"compared":{"type":"integer","minimum":2,"maximum":4},"failed":{"type":"integer","minimum":0,"maximum":2},"products":{"type":"array","minItems":2,"items":{"type":"object"}},"failures":{"type":"array","items":{"type":"object"}},"comparison":{"type":"object","properties":{"identity_matches":{"type":"array","items":{"type":"object"}},"same_product_proven":{"type":"boolean"},"lowest_listed_price_by_currency":{"type":"array","items":{"type":"object"}},"lowest_shipping_cost_by_currency":{"type":"array","items":{"type":"object"}},"buyable_product_indices":{"type":"array","items":{"type":"integer"}},"unavailable_product_indices":{"type":"array","items":{"type":"integer"}},"highest_rating_by_scale":{"type":"array","items":{"type":"object"}},"currencies":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}},"methodology":{"type":"object"},"fetched_at":{"type":"string","format":"date-time"}}}},{"name":"find_contacts","description":"Read the mandatory public disclosure of one domain and return its business contact data: company name, legal form, representatives, postal address split into street, house number, postal code, city and country, e-mails classified as general, role or personal, phone and fax normalised to E.164, VAT id, commercial register entry, supervisory authority, chamber, social profiles and the contact form with its field names. Only the queried domain is fetched, at most six pages. Every value carries the URL and the text snippet it was read from, nothing is guessed and no address pattern is synthesised. Fields the site does not publish are listed under unavailable_fields rather than filled. A mandatory disclosure is a legal obligation, not consent to advertising.","inputSchema":{"type":"object","description":"Either \"url\" or \"domain\". Only the queried domain is fetched.","properties":{"url":{"type":"string","format":"uri","description":"Absolute http or https URL of the site to read."},"domain":{"type":"string","description":"Bare host name such as example.com. https is assumed."},"deep":{"type":"boolean","default":true,"description":"true also reads the linked Impressum, Kontakt, Legal, About and Datenschutz pages. false reads the start page only and finds less."},"respect_robots":{"type":"boolean","default":true,"description":"Honour the origin robots.txt. Leave this on unless you own the domain."}},"anyOf":[{"required":["url"]},{"required":["domain"]}]}}]}