SciFig

Referencia de la API

Servidor MCP

Usa SciFig desde Claude, ChatGPT, Claude Code, Codex y Cursor a través del servidor MCP remoto.

Ver como Markdown

Servidor MCP#

URL del servidor: https://mcp.scifig.ai/mcp, Streamable HTTP. Los clientes compatibles con OAuth se conectan iniciando sesión en SciFig y autorizando el acceso; los que envían cabeceras pueden usar una clave API como Authorization: Bearer sk_live_….

HerramientaFunción
generate_figureCrear una ilustración científica a partir de una descripción
edit_figureEditar una imagen: instrucciones, opcionalmente una región enmascarada, fondo blanco, relación de aspecto, cambio de colores o sustitución de texto
detect_textDetectar el texto de una imagen antes de sustituirlo
upscale_figureAmpliar a 2K, 4K u 8K
convert_figureConvertir a SVG, PNG, PDF, TIFF o PPTX
generate_chartCrear un gráfico a partir de texto CSV o TSV o filas JSON, hasta 1 MB
edit_chartModificar la versión más reciente de un gráfico
generate_flowchartDibujar un diagrama de flujo en SVG, opcionalmente a partir de hasta 8 archivos adjuntos
edit_flowchartModificar la versión más reciente de un diagrama de flujo
get_jobEstado, créditos y enlaces de descarga de una tarea
list_figuresTareas recientes
get_credit_balanceSaldo de créditos, plan y límites

Las herramientas de creación esperan hasta 25 segundos. Si una tarea sigue ejecutándose, llama a get_job más tarde; volver a llamar a la herramienta de creación crea y cobra una tarea nueva. Los resultados incluyen cada enlace de descarga y, para gráficos y diagramas de flujo, el enlace que abre el resultado en el editor de SciFig.

Las herramientas de creación comprueban el ámbito figures:generate antes de descargar archivos adjuntos. Una conexión de solo lectura puede consultar tareas y créditos, pero no puede crear figuras.

Conecta tu cliente#

Claude, en claude.ai y Claude Desktop: Ajustes → Conectores → Añadir conector personalizado. Introduce la URL del servidor, inicia sesión en SciFig y permite el acceso.

ChatGPT: Ajustes → Aplicaciones → Avanzado → Modo de desarrollador. Crea una aplicación con la URL del servidor y autenticación OAuth.

Claude Code:

claude mcp add --transport http scifig https://mcp.scifig.ai/mcp

Codex (~/.codex/config.toml):

[mcp_servers.scifig]
url = "https://mcp.scifig.ai/mcp"

Cursor, en ~/.cursor/mcp.json, con una clave API creada en Ajustes → Desarrollador:

{
  "mcpServers": {
    "scifig": {
      "url": "https://mcp.scifig.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}

Los clientes sin OAuth pueden añadir la cabecera Authorization: Bearer sk_live_… con una clave API creada en Ajustes → Desarrollador.

Parámetros de las herramientas#

HerramientaParámetroObligatorioReglas
generate_figurepromptsí3–20 000 caracteres
aspect_rationo1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
qualitynostandard, advanced o premium
stylenoUno de los valores flat, 2-5d, line-art, hand-drawn, scientific, line, 3d, editorial, sketch, watercolor, auto
palettenoNombre de paleta de 1–64 caracteres o 1–4 colores #RRGGBB
reference_imagesnoHasta 3 imágenes: file_id, URL https o URL data; PNG, JPEG o WebP de hasta 20 MB, aproximadamente 3 MB para una URL data, consulta más abajo
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
edit_figureimagesífile_id, URL https o URL data; PNG, JPEG o WebP de hasta 20 MB, aproximadamente 3 MB para una URL data, consulta más abajo
operationnoinstruct por defecto, white_background, aspect_ratio, recolor o replace_text
instructionpara instruct1–2000 caracteres
masknoSolo para instruct: PNG de hasta 8 MB, con blanco en las zonas que se pueden modificar
aspect_ratiopara aspect_ratio1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
palettenoSolo para recolor: 1–8 colores #RRGGBB
text_detectionpara replace_textEl identificador devuelto por detect_text
replacementspara replace_text1–256 elementos [{"index", "text"}]: index de 0 a 255 obtenido de detect_text, cada índice una vez como máximo; text de 1–500 caracteres
qualitynoSe ignora en replace_text
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
detect_textimagesífile_id, URL https o URL data; PNG, JPEG o WebP de hasta 20 MB, aproximadamente 3 MB para una URL data, consulta más abajo
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
upscale_figureimagesífile_id, URL https o URL data; PNG, JPEG o WebP de hasta 20 MB, aproximadamente 3 MB para una URL data, consulta más abajo
scalesí2k, 4k u 8k
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
convert_figureimagesífile_id, URL https o URL data; PNG, JPEG o WebP de hasta 20 MB, aproximadamente 3 MB para una URL data, consulta más abajo; o el SVG de un diagrama de flujo mediante file_id
formatsísvg, png, pdf, tiff o pptx
vector_modenoSolo con el formato svg: editable_text o full_vector
dpinoNo para svg: 300, 600 o 1000
widthnoNo para svg; solo para fuentes SVG de diagramas de flujo: 256–4096 píxeles
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
generate_chartdatadata o rowsTexto CSV o TSV con fila de cabecera, hasta 1 MB, equivalente a 1 000 000 de caracteres
rowsdata o rowsEn lugar de data: 1–100 000 objetos que asignan nombres de columna a valores; enviados como CSV, hasta 1 MB
data_formatnocsv o tsv; si se omite, se detecta a partir de la primera línea
requestsíQué representar, 1–16.000 caracteres
chart_typesnoHasta 46 tipos de gráficos, sin duplicados; consulta gráficos
journal_stylenodefault, nature, science, cell, plos o acs
figure_widthnosingle, onehalf o double
color_palettenoNombre de paleta; consulta gráficos
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
edit_chartjob_idsíLa tarea del gráfico más reciente
instructionsí1–16.000 caracteres
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
generate_flowchartpromptsí1–8000 caracteres
aspect_rationoauto, 16:9, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 21:9
attachmentsnoHasta 8 archivos: file_id, URL https o URL data; PDF, DOC, DOCX, Markdown, texto, SVG, PNG, JPEG o WebP, hasta 32 MB cada uno
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
edit_flowchartjob_idsíLa tarea del diagrama de flujo más reciente
instructionsí1–8000 caracteres
idempotency_keynoOpcional; reutiliza solo para repetir la misma solicitud tras agotar el tiempo de espera o un error de red
get_jobjob_idsíUn identificador de tarea
list_figureslimitno1–20
cursornonext_cursor de la página anterior
get_credit_balance——Sin parámetros

generate_chart solo acepta datos de texto, hasta 1 MB. Para libros de Excel (y su sheet_name) o archivos más grandes, usa POST /charts/generations.

Cómo funcionan las herramientas#

  • El servidor está en https://mcp.scifig.ai/mcp (Streamable HTTP). Llama a esta API en tu nombre, por lo que los precios, créditos, límites y errores son los mismos.
  • Los parámetros de imagen y adjuntos aceptan una file_id, una URL https o una URL de datos. Las URL y URL de datos se cargan primero con POST /files, por lo que cuentan para los límites de carga. Se rechazan las URL de SciFig (pasa la file_id) y solo se siguen redirecciones a otras direcciones https.
  • Una solicitud al servidor MCP tiene un límite de 4 MB. Base64 aumenta el tamaño del archivo en un tercio, así que una URL de datos puede contener unos 3 MB. Envía los archivos más grandes como URL https.
  • El servidor comprueba tus credenciales solo en initialize y tools/call. Un token caducado o revocado devuelve 401 para que el cliente pueda actualizarlo o iniciar sesión de nuevo; una cuenta bloqueada o en proceso de eliminación devuelve 403.
  • Las imágenes terminadas se muestran directamente en el chat si no superan 1 MB. Cada resultado incluye enlaces de descarga; los gráficos y diagramas de flujo añaden un enlace para abrirlos en el editor de SciFig.
  • Cada creación usa un nuevo Idempotency-Key salvo que el asistente envíe idempotency_key. Volver a pedir el resultado crea y cobra un nuevo trabajo. Usa get_job para consultar el progreso.
  • Un resultado de error devuelve idempotency_key y, si existe un trabajo, job_id. Tras un tiempo de espera agotado o un error del servidor, reintenta con la misma clave o llama a get_job. Un rechazo como 402 INSUFFICIENT_CREDITS queda guardado bajo su clave; en ese caso, envía la solicitud de nuevo con una clave nueva.