protogrid

Search / com.preteworks/preteworks-api

PreteWorks API

R1· needs a key

One key for the document-to-web pipeline: scrape, AI-extract, build & edit PDFs, fill forms.

v1.0.2 · active · website · descriptor JSON · versions

An agent can connect on its own if it already holds PRETEWORKS_API_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality85good
Trust79of 100
Uptime, 30 days97%
Latency p50697 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "preteworks-api": {
      "type": "http",
      "url": "https://api.preteworks.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PRETEWORKS_API_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http preteworks-api https://api.preteworks.com/mcp --header "Authorization: Bearer ${PRETEWORKS_API_TOKEN}"
[mcp_servers.preteworks-api]
url = "https://api.preteworks.com/mcp"
bearer_token_env_var = "PRETEWORKS_API_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "preteworks-api": {
      "type": "remote",
      "url": "https://api.preteworks.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:PRETEWORKS_API_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "preteworks-api": {
      "type": "http",
      "url": "https://api.preteworks.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PRETEWORKS_API_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=preteworks-api&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnByZXRld29ya3MuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1BSRVRFV09SS1NfQVBJX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "preteworks-api": {
      "type": "http",
      "url": "https://api.preteworks.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PRETEWORKS_API_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "preteworks-api": {
      "httpUrl": "https://api.preteworks.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PRETEWORKS_API_TOKEN}"
      }
    }
  }
}
extensions:
  "preteworks-api":
    enabled: true
    name: "preteworks-api"
    type: streamable_http
    uri: "https://api.preteworks.com/mcp"
    headers:
      "Authorization": "Bearer ${PRETEWORKS_API_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${PRETEWORKS_API_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations29 of 29 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: markdown_to_pdf (idempotentHint); split_pdf (idempotentHint); extract_data (destructiveHint, idempotentHint); …
  • pass
    tools.token_costabout 3,884 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

29 tools, about 3,884 tokens to load them all · tool set 7943cdec1f7d · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 79 / 100

no-repository
provenance55
liveness99
freshness85
hygiene80

+dns-namespace +website +reachable +uptime-97% ~updated-41d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://api.preteworks.com/mcp streamable-httpapi_key ${PRETEWORKS_API_TOKEN}yes97%697 ms2025-11-252026-10-19

Tools (29)

answer_from_documentread-onlyAnswer 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.
batch_scraperead-onlyFetch 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.
crawl_siteread-onlyFetch 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.
data_to_spreadsheetTurn 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.
docx_to_pdfConvert a .docx document (base64) to a PDF. Returns a file_id and a ~1h URL.
docx_to_textread-onlyExtract the text of a .docx document (base64). Returns the text inline.
extract_dataread-onlyExtract 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.
extract_pdf_textread-onlyExtract 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.
file_to_markdownread-onlyConvert 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.
fill_pdf_formFill a PDF's form fields from a map of field -> value; optionally flatten. Returns a file_id and a ~1h URL.
images_to_pdfCombine PNG/JPEG images (base64) into a PDF, one image per page. Returns a file_id and a ~1h URL.
map_siteread-onlyDiscover the same-origin URLs linked from a page — the site map, with no page content fetched. Private/internal hosts are blocked.
markdown_to_pdfRender Markdown to a clean, print-styled PDF. Returns a file_id and a ~1h URL.
merge_pdfsCombine 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.
number_pdfStamp 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.
pdf_inforead-onlyRead a PDF's metadata (title, author, subject, keywords, creator, producer, dates) plus page count and page size, as JSON.
read_pdf_formread-onlyList a PDF's form fields (name, type, value, options) as JSON.
read_urlread-onlyFetch 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.
render_documentRender 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.
render_html_to_pdfRender 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.
rotate_pdfRotate every page of a PDF by 90, 180, or 270 degrees (clockwise). Returns a file_id (for chaining) and a ~1h download URL.
scrape_pageread-onlyFetch 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.
select_pagesKeep 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.
set_pdf_metadataSet 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.
split_pdfSplit 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.
summarize_documentread-onlySummarize 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.
url_to_pdfFetch 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.
url_to_screenshotFetch 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.
watermark_pdfStamp 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "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."
}