@exactpdf/mcp 0.2.11 → 0.2.12

package/README.md

@@ -8,9 +8,11 @@ Use it when an agent needs to inspect, merge, split, rotate, compress, extract,
 
 **Design principle:** every tool should work on first run, explain credit cost before risky work, return a local output path for files, and expose precise HTTP/API errors when something fails.
 
+Developer quickstart: [https://exactpdf.com/developers](https://exactpdf.com/developers)
+
 ## Setup
 
-1. Create an API key at [exactpdf.com](https://exactpdf.com) (Max → API keys).
+1. Create an API key at [max.exactpdf.com/account](https://max.exactpdf.com/account). New accounts get **20 free test credits**. Buy one-time credit packs only after the workflow works; no subscription is required for API/MCP.
 2. Export:
 
 ```bash
@@ -60,6 +62,14 @@ Safe first run:
 
 Document outputs are saved to `EXACTPDF_API_OUTPUT_DIR` or your OS temp directory. Paid document tools consume credits only on successful output. Async speech jobs are metered by generated minutes.
 
+Credit model:
+
+- Free probes: checklist, account, PDF info, voice preview, speech cost estimate, and job polling.
+- New accounts: 20 free test credits for API/MCP workflows.
+- Standard document tools: 1 credit only after a successful output.
+- Long audio jobs: metered by generated minutes.
+- One-time packs: available in Max Account when you need more; no subscription required for API/MCP.
+
 | Tool | Endpoint | Credits |
 |------|----------|--------:|
 | `exactpdf_first_run_checklist` | local guidance | 0 |
@@ -151,6 +161,7 @@ The package must exist on the public npm registry before the MCP Registry can ve
 
 ## Docs
 
+- [https://exactpdf.com/developers](https://exactpdf.com/developers)
 - [https://exactpdf.com/docs/api](https://exactpdf.com/docs/api)
 
 ## License

package/dist/run.d.ts

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
 /**
  * ExactPDF MCP — stdio server for Cursor / Claude Desktop / Codex.
- * Requires EXACTPDF_API_KEY (sk_live_…) from exactpdf.com (Max dashboard → API keys).
+ * Requires EXACTPDF_API_KEY (sk_live_…) from max.exactpdf.com/account.
+ * New accounts get free test credits; one-time credit packs are available
+ * after the first workflow works.
  *
+ * @see https://exactpdf.com/developers
  * @see https://exactpdf.com/docs/api
  */
 export {};

package/dist/run.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
 /**
  * ExactPDF MCP — stdio server for Cursor / Claude Desktop / Codex.
- * Requires EXACTPDF_API_KEY (sk_live_…) from exactpdf.com (Max dashboard → API keys).
+ * Requires EXACTPDF_API_KEY (sk_live_…) from max.exactpdf.com/account.
+ * New accounts get free test credits; one-time credit packs are available
+ * after the first workflow works.
  *
+ * @see https://exactpdf.com/developers
  * @see https://exactpdf.com/docs/api
  */
 import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
@@ -20,12 +23,12 @@ function outputDir() {
 function requireKey() {
     const k = process.env.EXACTPDF_API_KEY?.trim();
     if (!k) {
-        throw new Error('EXACTPDF_API_KEY is not set. Create a key at exactpdf.com (Max → API keys), then export EXACTPDF_API_KEY=sk_live_…');
+        throw new Error('EXACTPDF_API_KEY is not set. Create a key with free test credits at https://max.exactpdf.com/account, then export EXACTPDF_API_KEY=sk_live_…. Quickstart: https://exactpdf.com/developers');
     }
     return k;
 }
-const server = new McpServer({ name: 'exactpdf', version: '0.2.11' }, {
-    instructions: 'ExactPDF turns local PDFs into production outputs for agents: inspect metadata, merge/split/rotate/compress, create portal-ready merge/images workflows, extract text/structured Markdown, create voice previews, and queue async PDF speech/audiobook/translation/presentation narration jobs. Start with exactpdf_first_run_checklist, then exactpdf_account and exactpdf_pdf_info before paid work. Free tools: first-run checklist, account, pdf-info, voice-preview, speech cost estimate. Standard document tools cost 1 credit on success, including launch portal-ready workflows. Async speech jobs are metered by generated minutes. Use absolute local file paths; binary outputs are saved to EXACTPDF_API_OUTPUT_DIR or the OS temp directory. For async jobs, submit first, then poll exactpdf_get_speech_job, then download with exactpdf_download_audio when succeeded.',
+const server = new McpServer({ name: 'exactpdf', version: '0.2.12' }, {
+    instructions: 'ExactPDF turns local PDFs into production outputs for agents: inspect metadata, merge/split/rotate/compress, create portal-ready merge/images workflows, extract text/structured Markdown, create voice previews, and queue async PDF speech/audiobook/translation/presentation narration jobs. Start with exactpdf_first_run_checklist, then exactpdf_account and exactpdf_pdf_info before paid work. New users can create a key with free test credits at https://max.exactpdf.com/account; developer quickstart: https://exactpdf.com/developers. Free tools: first-run checklist, account, pdf-info, voice-preview, speech cost estimate. Standard document tools cost 1 credit on success, including launch portal-ready workflows. Async speech jobs are metered by generated minutes. Use absolute local file paths; binary outputs are saved to EXACTPDF_API_OUTPUT_DIR or the OS temp directory. For async jobs, submit first, then poll exactpdf_get_speech_job, then download with exactpdf_download_audio when succeeded.',
 });
 async function saveBinaryFromResponse(res, prefix, fallbackExt) {
     const buf = Buffer.from(await res.arrayBuffer());
@@ -68,7 +71,8 @@ server.registerTool('exactpdf_first_run_checklist', {
                 ok: true,
                 setup: {
                     required_env: 'EXACTPDF_API_KEY=sk_live_...',
-                    create_key_url: `${BASE}/max/account`,
+                    create_key_url: 'https://max.exactpdf.com/account',
+                    developer_quickstart: `${BASE}/developers`,
                     optional_output_dir: 'EXACTPDF_API_OUTPUT_DIR=/absolute/output/folder',
                     docs: `${BASE}/docs/api`,
                     openapi: `${BASE}/openapi.json`,
@@ -81,7 +85,9 @@ server.registerTool('exactpdf_first_run_checklist', {
                 ],
                 credit_model: {
                     free: ['exactpdf_first_run_checklist', 'exactpdf_account', 'exactpdf_pdf_info', 'exactpdf_voice_preview', 'exactpdf_estimate_speech_cost', 'job polling'],
+                    starter_trial: 'New accounts get 20 free test credits for API/MCP workflows.',
                     standard_document_tools: '1 credit only after successful output',
+                    credit_packs: 'Buy one-time credit packs when the workflow works; subscription is not required for API/MCP.',
                     launch_portal_ready_workflows: '1 credit on successful output: exactpdf_merge_and_compress_pdfs, exactpdf_images_to_pdf_and_compress',
                     speech_audiobook_presentation: '1 credit per generated minute',
                     translate_and_speak: '3 credits per generated minute',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exactpdf/mcp",
-  "version": "0.2.11",
-  "description": "MCP server for ExactPDF — PDF tools, voice previews, async PDF speech/audiobook jobs, polling, and API credits.",
+  "version": "0.2.12",
+  "description": "MCP server for ExactPDF — agent PDF workflows, structured Markdown/RAG, merge/compress, voice previews, async audio jobs, and API credits.",
   "mcpName": "com.exactpdf/mcp",
   "type": "module",
   "main": "./dist/run.js",
@@ -19,7 +19,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "homepage": "https://exactpdf.com/docs/api",
+  "homepage": "https://exactpdf.com/developers",
   "bugs": {
     "url": "https://exactpdf.com/docs/api",
     "email": "support@exactpdf.com"

package/server.json

@@ -3,13 +3,13 @@
   "name": "com.exactpdf/mcp",
   "title": "ExactPDF",
   "description": "Agent-facing PDF API: merge, split, rotate, compress, images, metadata, text, Markdown, voice previews, async speech/audiobook, multilingual speech, and presentation narration jobs.",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "websiteUrl": "https://exactpdf.com/docs/api",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@exactpdf/mcp",
-      "version": "0.2.11",
+      "version": "0.2.12",
       "transport": {
         "type": "stdio"
       }