@bigapi/mcp 0.1.0 → 0.3.0

package/README.md

@@ -14,7 +14,7 @@ Gives Claude Desktop, Cursor, Cline, Windsurf and any MCP-capable agent the file
 | `get_access` | Free API key, instantly, no signup – 100 free operations |
 | `get_balance` · `get_usage` · `set_monthly_cap` · `get_pricing` | Account |
 
-**1 cent per operation. 100 free. Balance never expires. Failed calls are free.** Servers in Germany, files deleted after delivery.
+**$0.01 (one US cent) per operation. 100 free. Balance never expires. Failed calls are free.** Servers in Germany, files deleted after delivery.
 
 ## Install
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bigapi/mcp",
-  "version": "0.1.0",
-  "description": "MCP server for bigapi.dev – the output layer for AI agents: render HTML/Markdown to PDF, merge/split/compress PDFs, convert images. One cent per operation.",
+  "version": "0.3.0",
+  "description": "MCP server for bigapi.dev \u2013 the output layer for AI agents: render HTML/Markdown to PDF, merge/split/compress PDFs, convert images. One cent per operation.",
   "main": "index.js",
   "scripts": {
     "start": "node src/index.js",

package/src/index.js

@@ -5,10 +5,10 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { apiJson, opJson, opFiles, getKey, saveKey, configPath, BigapiError, BASE_URL } from './client.js';
 
-const server = new McpServer({ name: 'bigapi', version: '0.1.0' }, {
+const server = new McpServer({ name: 'bigapi', version: '0.3.0' }, {
   instructions: `bigapi.dev – the output layer for AI agents. Deterministic file operations an LLM cannot do itself:
 render HTML/Markdown/URLs to PDF or PNG, merge/split/rotate/compress PDFs, turn PDF pages into images, resize/convert/watermark images.
-Pricing: 1 cent per operation, 100 free operations per new key (no signup), balance never expires, failed calls are free.
+Pricing: $0.01 (one US cent) per operation, 100 free operations per new key (no signup), balance never expires, failed calls are free.
 If no API key is configured, call get_access first – it is free and instant. Files are given and returned as local paths.`,
 });
 
@@ -20,8 +20,8 @@ function fail(e) {
   if (e instanceof BigapiError) {
     const b = e.body || {};
     let hint = '';
-    if (b.error === 'balance_empty') hint = `\nGuthaben leer. Aufladen (ab 5 €, verfällt nie): ${b.upgrade_url}`;
-    if (b.error === 'cap_reached') hint = `\nMonatsobergrenze dieses Keys erreicht (${b.monthly_cap_cents} ct). Mit set_monthly_cap anheben.`;
+    if (b.error === 'balance_empty') hint = `\nBalance empty. Add credit (from $5, never expires): ${b.upgrade_url}`;
+    if (b.error === 'cap_reached') hint = `\nMonthly cap of this key reached (${b.monthly_cap_cents} US cents). Raise it with set_monthly_cap.`;
     if (b.error === 'rate_limited') hint = `\nZu viele Anfragen. In ${b.retry_after ?? 1} s erneut versuchen.`;
     if (b.error === 'no_api_key' || e.status === 401) hint = `\nKein gültiger Key. Tool get_access aufrufen (kostenlos).`;
     return { isError: true, content: [{ type: 'text', text: `bigapi error ${e.status}: ${b.error}${hint}\n${JSON.stringify(b)}` }] };
@@ -32,7 +32,7 @@ const run = (fn) => async (args) => { try { return await fn(args); } catch (e) {
 
 // ---- Zugang -----------------------------------------------------------------
 server.tool('get_access',
-  'Get a free bigapi API key instantly – no signup, no credit card. 100 free operations for 7 days, then 1 cent per operation. The key is stored locally and used by all other tools. Call this once if no key is configured.',
+  'Get a free bigapi API key instantly – no signup, no credit card. 100 free operations for 7 days, then $0.01 per operation. The key is stored locally and used by all other tools. Call this once if no key is configured.',
   { name: z.string().optional().describe('Optional label for the key, e.g. "claude-desktop"') },
   run(async ({ name }) => {
     const existing = await getKey();
@@ -51,7 +51,7 @@ server.tool('get_balance',
 server.tool('get_usage', 'Operations and cost this month, grouped by operation.', {}, run(async () => ok(await apiJson('GET', '/v1/usage'))));
 
 server.tool('set_monthly_cap',
-  'Raise or lower the monthly spending cap (in cents) of the configured key. Default is 1000 (10 €). Protects against runaway loops.',
+  'Raise or lower the monthly spending cap (in US cents) of the configured key. Default is 1000 ($10). Protects against runaway loops.',
   { monthly_cap_cents: z.number().int().min(0).max(1_000_000) },
   run(async ({ monthly_cap_cents }) => {
     const bal = await apiJson('GET', '/v1/balance');
@@ -111,6 +111,36 @@ server.tool('pdf_to_images', 'Render PDF pages as JPEG (default) or PNG images
     format: z.enum(['jpeg', 'png']).default('jpeg'), quality: z.number().int().min(30).max(100).default(85), output_path: z.string().optional(), idempotency_key: z.string().optional() },
   run(async (a) => ok(await opFiles('/v1/pdf/pages', [['file', a.file]], { dpi: String(a.dpi), first: a.first_page && String(a.first_page), last: a.last_page && String(a.last_page), format: a.format, quality: String(a.quality) }, a.output_path, a.idempotency_key), 'Pages rendered.')));
 
+// ---- Welle 1a: Screenshot · OCR · PDF/A -----------------------------------------
+server.tool('screenshot',
+  'Screenshot of a public URL with device presets (desktop, laptop, tablet, mobile). Full page by default. Returns the local output path. 1 cent.',
+  { url: z.string().url(), device: z.enum(['desktop', 'laptop', 'tablet', 'mobile']).default('desktop'),
+    full_page: z.boolean().default(true), format: z.enum(['png', 'jpeg']).default('png'),
+    quality: z.number().int().min(30).max(100).default(85).describe('JPEG only'),
+    delay_ms: z.number().int().min(0).max(10000).optional().describe('Extra wait after load'),
+    output_path: z.string().optional(), idempotency_key: z.string().optional() },
+  run(async (a) => ok(await opJson('/v1/screenshot',
+    { url: a.url, device: a.device, fullPage: a.full_page, format: a.format, quality: a.quality, delayMs: a.delay_ms },
+    a.output_path, a.idempotency_key), 'Screenshot taken.')));
+
+server.tool('ocr',
+  'OCR a scanned PDF or image (local path) into a searchable PDF (default), plain text, or JSON per page. Languages e.g. "deu", "eng", "deu+eng". 1 cent PER PAGE.',
+  { file: z.string(), lang: z.string().default('deu+eng'),
+    output: z.enum(['pdf', 'text', 'json']).default('pdf'),
+    dpi: z.number().int().min(100).max(600).default(300),
+    output_path: z.string().optional(), idempotency_key: z.string().optional() },
+  run(async (a) => ok(await opFiles('/v1/ocr', [['file', a.file]], { lang: a.lang, output: a.output, dpi: String(a.dpi) }, a.output_path, a.idempotency_key), 'OCR done.')));
+
+server.tool('pdf_to_pdfa',
+  'Convert a PDF (local path) to archival PDF/A-2b with embedded fonts – for long-term storage and compliance. 5 cents.',
+  { file: z.string(), output_path: z.string().optional(), idempotency_key: z.string().optional() },
+  run(async (a) => ok(await opFiles('/v1/pdf/pdfa', [['file', a.file]], {}, a.output_path, a.idempotency_key), 'Converted to PDF/A.')));
+
+server.tool('office_to_pdf',
+  'Convert an Office document (local path: DOCX, DOC, XLSX, XLS, PPTX, PPT, ODT, ODS, ODP, RTF, CSV, TXT) to PDF via LibreOffice. 1 cent PER PAGE.',
+  { file: z.string(), output_path: z.string().optional(), idempotency_key: z.string().optional() },
+  run(async (a) => ok(await opFiles('/v1/office/pdf', [['file', a.file]], {}, a.output_path, a.idempotency_key), 'Converted to PDF.')));
+
 // ---- Images --------------------------------------------------------------------
 server.tool('image_process', 'Resize, crop, rotate, convert (jpeg/png/webp/avif/tiff), compress, strip EXIF and/or watermark an image in one call. 1 cent.',
   { file: z.string(),