Identik MCP — firma electrónica y firma digital argentina para agentes de IA

ES · Servidores MCP remotos de Identik para firmar documentos con validez legal en Argentina (Ley 25.506) desde un agente de IA: crear un documento a partir de una plantilla, enviarlo a firmar, seguir su estado, descargar el PDF firmado con su constancia y verificar firmas criptográficamente.

EN · Remote MCP servers for Identik, an Argentine e-signature platform (Ley 25.506). Let an AI agent create a document from a template, send it out for signature, track status, download the signed PDF with its audit certificate, and cryptographically verify signatures.

Este repositorio contiene documentación y manifiestos para conectarse a los servidores MCP alojados por Identik. No contiene el código del producto (Identik es un servicio comercial alojado).

This repository holds documentation and manifests for connecting to Identik's hosted MCP servers. It does not contain the product source (Identik is a commercial hosted service).

Las dos plataformas / The two platforms

Identik expone dos servidores MCP, uno por nivel de firma. Las herramientas son las mismas; cambia el valor legal de la firma resultante.

Identik exposes two MCP servers, one per signature level. The tool set is identical; what differs is the legal weight of the resulting signature.

Los sandboxes son entornos separados, con sus propias cuentas, datos, créditos y base de datos: sirven para desarrollar y evaluar la integración sin tocar producción. Los documentos que emiten no tienen validez, por diseño y de forma verificable: la constancia sale marcada «PRUEBA — FIRMA NO VÁLIDA», el sello se hace con un certificado de prueba distinto al de producción, y el validador público lo reconoce y rechaza el documento como de prueba (validar_pdf devuelve testEnvironment: true y ok: false).

The sandboxes are separate environments with their own accounts, data, credits and database — use them to build and evaluate the integration without touching production. Documents they issue are not valid, by design and verifiably so: the audit certificate is watermarked «PRUEBA — FIRMA NO VÁLIDA», sealing uses a test certificate distinct from the production one, and the public validator recognises it and rejects the document as a test (validar_pdf returns testEnvironment: true and ok: false).

Transporte y autenticación / Transport and authentication

• Transporte / Transport: Streamable HTTP, stateless. Sólo POST (GET y DELETE devuelven 405). / POST only (GET and DELETE return 405).
• Autenticación / Authentication: encabezado HTTP Authorization: Bearer api_...
• Sin OAuth. El token es un token de API por cuenta. / No OAuth. The token is a per-account API token.

Cómo obtener un token / How to get a token

Requiere un token de API de Identik. Solicitalo en contacto@identik.me, o generalo desde tu cuenta en Configuración → API Tokens.

An Identik API token is required. Request one at contacto@identik.me, or generate it in your account under Configuración → API Tokens.

Sin token, el servidor responde 401:

$ curl -sS -X POST https://electronica.identik.me/api/mcp \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json, text/event-stream' \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
{"jsonrpc":"2.0","error":{"code":-32001,"message":"Falta el token de API (encabezado Authorization: Bearer api_...)."},"id":null}

Ver examples/smoke-test.sh. / See examples/smoke-test.sh.

Herramientas / Tools

Diez herramientas, con nombres en español (la plataforma es de mercado argentino). Idénticas en ambas plataformas, salvo lo indicado.

Ten tools, named in Spanish (the platform targets the Argentine market). Identical across both platforms except where noted.

Flujo típico / Typical flow:

listar_plantillas  →  crear_documento_desde_plantilla  →  enviar_documento
                                                            ↓
                        obtener_documento / traza_auditoria (seguimiento)
                                                            ↓
                                            descargar_documento_firmado

Sólo en firma electrónica / Electronic signature only

crear_documento_desde_plantilla acepta requiere_biometria: true — cada firmante debe aprobar una verificación biométrica (DNI + prueba de vida) antes de firmar. Consume 1 crédito de verificación por verificación aprobada. Recomendado combinarlo con dni_numero en cada firmante, para que la verificación se valide contra ese dato.

crear_documento_desde_plantilla accepts requiere_biometria: true — each signer must pass a biometric identity check (ID document + liveness) before signing. Consumes 1 verification credit per passed check. Best combined with each signer's dni_numero, so the check is validated against that value.

Sólo en firma digital / Digital signature only

Cada firmante se identifica por cuil, que debe corresponder a su certificado de firma digital.

Each signer is identified by cuil, which must match their digital-signature certificate.

Configuración por cliente / Client configuration

En todos los ejemplos, reemplazá api_... por tu token, y electronica.identik.me por firma.identik.me si querés firma digital (o por el host sandbox-* para evaluar).

In every example, replace api_... with your token, and electronica.identik.me with firma.identik.me for digital signature (or with the sandbox-* host to evaluate).

Claude Code

claude mcp add identik --transport http https://electronica.identik.me/api/mcp \
  --header "Authorization: Bearer api_..."

--header se puede repetir. Forma equivalente en .mcp.json (versionable en el proyecto) / --header is repeatable. Equivalent .mcp.json project file:

{
  "mcpServers": {
    "identik": {
      "type": "http",
      "url": "https://electronica.identik.me/api/mcp",
      "headers": {
        "Authorization": "Bearer ${IDENTIK_TOKEN}"
      }
    }
  }
}