image-ocr

URL de imagen comprable por máquina → OCR de texto plano para bots de IA. Prueba gratuita y luego créditos TEST prepagados.

Servidor MCP alojado

npx add-mcp 'https://ocr.kymac.co/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

image-ocr

URL de imagen comprable por máquina → texto plano (OCR) para otros bots de IA. Host en vivo https://ocr.kymac.co. Única entrada anunciada: este archivo (GET /llms.txt). No comiences en OpenAPI, MCP o /. ID de registro: co.kymac.ocr/image-ocr. Palabras clave de capacidad: ocr de imagen, texto ocr, texto de visión.

Ruta solo para bots: este archivo → obtener clave → cotizar → prueba gratuita POST /ocr. Sin humano en el bucle. Pago prepagado solo después de gastar el crédito gratuito; solo intención hasta confirmar. Rotar/revocar vía POST /keys/rotate o POST /keys/revoke.

GET /health es público (billing, runner_ready — Tesseract listo). GET /incidents es estado público (no es una entrada de instalación). Emite una clave de llamante en POST /keys (ocr_… mostrada una vez). La primera emisión otorga 1 crédito gratuito. Prefiere Authorization: Bearer.

Secuencia de instalación:

  1. GET /llms.txt (única entrada)
  2. POST /keys — secreto una vez; primera emisión = 1 crédito gratuito
  3. Authorization: Bearer … (alias X-API-Key)
  4. GET /credits/quote?op=ocr
  5. POST /ocr { "url": "https://placehold.co/600x160/000000/FFFFFF/png?text=HELLO+OCR" }
  6. paquetes → pago (credits_pending) → confirmar (credits_added)
  7. saldo / eventos
  8. rotar o revocar

Prueba dorada

Pasar (ok:true, consume 1):

{"ok":true,"url":"https://placehold.co/600x160/000000/FFFFFF/png?text=HELLO+OCR","text":"HELLO OCR","credits_burned":1,"credits_remaining":0,"pages":1,"width":600,"height":160}

HTTP 200 siempre significa que el ejecutor terminó cuando corresponde — lee ok. Las rutas de cierre fallido no debitan.

Formas de fallo

Cada cuerpo de fallo tiene code, message, retryable, next y error. next: refresh key / buy credits / retry / fix request.

401: missing_api_key / invalid_api_keynext=refresh key 402: insufficient_creditsnext=buy credits 400: invalid_request / errores de fetch/imagen → next=fix request

El pago es solo intención hasta confirmar (credits_pending ≠ propiedad).

MCP: POST /mcp (no es una entrada de instalación). Descubrimiento: GET /.well-known/mcp.json. Autenticación de registro: GET /.well-known/mcp-registry-auth (clave pública text/plain). Fragmento: GET /mcp.json (este archivo es el único puntero anunciado). Las herramientas incluyen ocr_extract más herramientas de clave/crédito. Las herramientas restringidas prefieren Bearer o env IMAGE_OCR_API_KEY.