{"server":{"name":"com.preteworks/preteworks-api","title":"PreteWorks API","$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","remotes":[{"url":"https://api.preteworks.com/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"isRequired":true,"description":"Bearer <API key> from https://api.preteworks.com/signup (free tier: 500 units/mo, no card)."}]}],"version":"1.0.2","websiteUrl":"https://api.preteworks.com","description":"One key for the document-to-web pipeline: scrape, AI-extract, build & edit PDFs, fill forms."},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-09-08T03:05:16.052887Z","publishedAt":"2026-09-08T03:05:16.052887Z","statusChangedAt":"2026-09-08T03:05:16.052887Z"},"dev.protogrid/connectability":{"class":"R1","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://api.preteworks.com/mcp","transport":"streamable-http","templated":false,"headers":[{"name":"Authorization","required":true,"secret":true,"value":null,"secret_names":["PRETEWORKS_API_TOKEN"]}],"auth":{"type":"api_key","location":null,"secret_name":"PRETEWORKS_API_TOKEN","oauth":null},"protocol":{"supported_versions":["2025-11-25"],"stateless":false},"health":{"reachable":true,"uptime_30d":0.9741379,"latency_ms_p50":697,"consecutive_failures":0,"last_probe_at":"2026-10-19T17:41:02.010Z","last_ok_at":"2026-10-19T17:41:02.010Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"answer_from_document","title":"Answer a question from a document (AI)","description":"Answer a question grounded ONLY in a source document — a web page, PDF, Office file, or raw text. Provide 'question' plus ONE source: 'url', 'pdf', 'file' (base64), or 'text'. Says so when the answer isn't in the document.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"batch_scrape","title":"Batch: URLs to Markdown","description":"Fetch up to 10 public URLs and return each as clean Markdown, in one call — for research/RAG over several pages at once. Private/internal hosts are blocked.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"crawl_site","title":"Crawl a site to Markdown","description":"Fetch a URL plus up to 7 more same-origin pages it links to (≤8 total), each as clean Markdown. Bounded and synchronous. Private/internal hosts are blocked.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"data_to_spreadsheet","title":"Create a spreadsheet from rows","description":"Turn rows of data into a downloadable XLSX (default) or CSV. 'rows' is an array of objects (keys → header row) or an array of arrays (first row is the header). Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"docx_to_pdf","title":"DOCX to PDF","description":"Convert a .docx document (base64) to a PDF. Returns a file_id and a ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"docx_to_text","title":"DOCX to text","description":"Extract the text of a .docx document (base64). Returns the text inline.","annotations":{"readOnlyHint":true,"openWorldHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"extract_data","title":"Extract structured data (AI)","description":"Extract specified fields from a web page, PDF, or Office file as JSON, using AI. Provide 'fields' plus ONE source: a 'url', a 'pdf' (file_id or base64), or a 'file' (base64 .docx/.xlsx/.csv). Returns a JSON object mapping each field to its value, or null when absent.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"extract_pdf_text","title":"Extract text from a PDF","description":"Extract the text content of a PDF — for RAG, summarization, or search. Accepts a file_id (from a prior tool) or a base64-encoded PDF, and returns the text inline. Not OCR: a scanned/image-only PDF returns little or no text.","annotations":{"readOnlyHint":true,"openWorldHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"file_to_markdown","title":"File to Markdown","description":"Convert a Word (.docx), Excel (.xlsx) or CSV file (base64) into clean Markdown — for RAG, agents and pipelines. DOCX keeps headings/lists/tables; spreadsheets become Markdown tables (one per sheet). Returns Markdown inline. Optional 'format' (docx|xlsx|csv) overrides auto-detection.","annotations":{"readOnlyHint":true,"openWorldHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"fill_pdf_form","title":"Fill a PDF form","description":"Fill a PDF's form fields from a map of field -> value; optionally flatten. Returns a file_id and a ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"images_to_pdf","title":"Images to PDF","description":"Combine PNG/JPEG images (base64) into a PDF, one image per page. Returns a file_id and a ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"map_site","title":"Map a site's URLs","description":"Discover the same-origin URLs linked from a page — the site map, with no page content fetched. Private/internal hosts are blocked.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"markdown_to_pdf","title":"Render Markdown to PDF","description":"Render Markdown to a clean, print-styled PDF. Returns a file_id and a ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"merge_pdfs","title":"Merge PDFs","description":"Combine 2+ PDFs into a single PDF, in the order given. Inputs are file_ids (from prior tools) or base64 PDFs. Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"number_pdf","title":"Number PDF pages","description":"Stamp a page number on every page. position: bottom-center (default) | bottom-left | bottom-right | top-center | top-left | top-right. format supports {n} and {total}. Returns a file_id + ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"pdf_info","title":"Read PDF info","description":"Read a PDF's metadata (title, author, subject, keywords, creator, producer, dates) plus page count and page size, as JSON.","annotations":{"readOnlyHint":true,"openWorldHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"read_pdf_form","title":"Read a PDF form","description":"List a PDF's form fields (name, type, value, options) as JSON.","annotations":{"readOnlyHint":true,"openWorldHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"read_url","title":"Read a web page as Markdown","description":"Fetch a public http/https URL and return its main content as clean Markdown — ideal for giving an agent readable web content for research or RAG. Private/internal hosts are blocked.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"render_document","title":"Generate a document","description":"Render a structured document to a PDF from a named template (invoice, receipt, report). Money/totals are computed for you. Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"render_html_to_pdf","title":"Render HTML to PDF","description":"Render a full HTML document to a PDF. External subresources are blocked for safety — inline images/fonts as data: URIs. Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"rotate_pdf","title":"Rotate PDF","description":"Rotate every page of a PDF by 90, 180, or 270 degrees (clockwise). Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"scrape_page","title":"Scrape a web page (HTML + links + metadata)","description":"Fetch a public http/https URL and return its rendered HTML, the links on the page, and page metadata (title/description/OpenGraph/canonical/favicon) — in one render. For clean Markdown use read_url instead. Private/internal hosts are blocked.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"select_pages","title":"Select PDF pages","description":"Keep only the specified pages of a PDF (e.g. [1,3,5]) and drop the rest, preserving order. Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"set_pdf_metadata","title":"Set PDF metadata","description":"Set a PDF's title, author, subject, keywords (array or comma string) and/or creator. Only the fields you provide change. Returns a file_id + ~1h URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"split_pdf","title":"Split a PDF","description":"Split a PDF into multiple PDFs — one per page by default, or by page ranges like '1-3;4-6'. Returns a file_id + URL per part.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"summarize_document","title":"Summarize a document (AI)","description":"Summarize a web page, PDF, Office file (.docx/.xlsx/.csv), or raw text using AI. Provide ONE source: 'url', 'pdf' (file_id or base64), 'file' (base64), or 'text'. Optional 'max_words'. Returns the summary.","annotations":{"readOnlyHint":true,"openWorldHint":true},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"url_to_pdf","title":"Snapshot a web page as PDF","description":"Fetch a public http/https URL and render the live page to a PDF. Returns a file_id (chainable into the PDF tools) and a ~1h download URL. Private/internal hosts are blocked.","annotations":{"readOnlyHint":false,"openWorldHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"url_to_screenshot","title":"Screenshot a web page","description":"Fetch a public http/https URL and capture a PNG screenshot. Set full_page for the entire scroll height. Returns a file_id and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"},{"name":"watermark_pdf","title":"Watermark PDF","description":"Stamp a diagonal grey text watermark (e.g. \"DRAFT\", \"CONFIDENTIAL\") across every page of a PDF. Returns a file_id (for chaining) and a ~1h download URL.","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T17:41:02.010Z"}],"dev.protogrid/trust":{"score":79,"components":{"hygiene":80,"liveness":99,"freshness":85,"provenance":55},"drivers":["+dns-namespace","+website","+reachable","+uptime-97%","~updated-42d-ago","-no-repository"],"flags":["no-repository"],"blocked":false,"computed_at":"2026-10-19T21:35:43.161Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":85,"label":"good","components":{"auth":null,"hygiene":86,"protocol":75,"stability":100,"dependencies":null},"checks":[{"id":"protocol.modern","detail":"newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28","status":"warn","category":"protocol"},{"id":"protocol.stateless","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"protocol.transport","detail":"streamable HTTP","status":"pass","category":"protocol"},{"id":"protocol.list_ttl","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"auth.prm","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.as_metadata","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.cimd","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.secret_in_url","detail":"no templated URL","status":"na","category":"auth"},{"id":"tools.descriptions","detail":"every tool has a description","status":"pass","category":"hygiene"},{"id":"tools.description_length","detail":"descriptions are concise","status":"pass","category":"hygiene"},{"id":"tools.schemas","detail":"every tool has an object input schema","status":"pass","category":"hygiene"},{"id":"tools.annotations","detail":"29 of 29 tools declare readOnlyHint or destructiveHint","status":"pass","category":"hygiene"},{"id":"tools.directory_hints","detail":"no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: set_pdf_metadata (idempotentHint); merge_pdfs (idempotentHint); select_pages (idempotentHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 3,884 tokens to load every tool","status":"pass","category":"hygiene"},{"id":"tools.api_dump","detail":"tools are not a one-to-one API dump","status":"pass","category":"hygiene"},{"id":"stability.changes","detail":"no tool changes in 30 days","status":"pass","category":"stability"},{"id":"stability.rug_pull","detail":"no tool changed its meaning under the same name","status":"pass","category":"stability"},{"id":"deps.known_vulns","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.mcp_sdk_version","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.resolvable","detail":"no npm or PyPI package","status":"na","category":"dependencies"}],"drivers":["-tools.directory_hints","~protocol.modern"],"flags":[],"tool_count":29,"token_estimate":3884,"tools_hash":"7943cdec1f7db9b4b40afd57a066fe6c","tools_changed_at":null,"computed_at":"2026-10-19T21:10:12.258Z","disclaimer":"Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed."},"dev.protogrid/identity":{"canonical_id":"com.preteworks/preteworks-api","aliases":[],"alias_count":0,"repository_key":null,"owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/com.preteworks%2Fpreteworks-api/tools","arguments":{"name":"com.preteworks/preteworks-api"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/com.preteworks%2Fpreteworks-api/connection?target=mcpServers","arguments":{"name":"com.preteworks/preteworks-api","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}