Integre Verdacert en cualquier agente de IA en 5 minutos

1. Obtenga un token sandbox (60 segundos, sin lista de espera)

Autoservicio en verdacert.com/onboarding. Inicie sesión con su correo electrónico, asigne un nombre a su empresa, genere una clave sandbox - listo. Las claves en vivo se activan en cuanto agrega un método de pago predeterminado; sin puerta de aprobación humana.

# Tokens look like:
vc_sandbox_p7q8r…           # free, synthetic flow
vc_live_abc123…             # real orders, real money

2. Elija la forma de su integración

MCP - Claude Desktop, Cursor, frameworks de agentes

Verdacert ofrece un servidor MCP streamable-HTTP con siete herramientas: get_capabilities, quote, submit, get_status, get_result, refund, verify_certificate. Apunte cualquier cliente MCP a https://verdacert.com/api/mcp con su token bearer.

Configuración de Claude Desktop

Agregue a ~/Library/Application Support/Claude/claude_desktop_config.json (o el equivalente en su sistema operativo):

{
  "mcpServers": {
    "verdacert": {
      "url": "https://verdacert.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vc_sandbox_…"
      }
    }
  }
}

Configuración de MCP en Cursor

Settings → MCP → Add new MCP server. El mismo JSON de arriba.

JSON-RPC programático (cualquier cliente HTTP)

curl https://verdacert.com/api/mcp \
  -H 'Authorization: Bearer vc_sandbox_…' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Vercel AI SDK

Un solo import le da las siete herramientas, tipadas y listas para insertar en su llamada de generateText / streamText / de agente. El paquete se publica como @verdacert/ai-sdk-tools.

Instalación

pnpm add @verdacert/ai-sdk-tools ai zod
# or: npm i @verdacert/ai-sdk-tools ai zod

Uso (con Vercel AI Gateway - recomendado)

import { generateText, isStepCount } from "ai";
import { createVerdacertTools } from "@verdacert/ai-sdk-tools";

const tools = createVerdacertTools({
  apiKey: process.env.VERDACERT_API_KEY!,
});

const { text } = await generateText({
  // Provider-string model. Routes through AI Gateway automatically
  // when AI_GATEWAY_API_KEY is set (auto-injected on Vercel).
  model: "anthropic/claude-sonnet-4",
  tools,
  stopWhen: isStepCount(20), // multi-step agent loop
  prompt:
    "Quote a 3-page Farsi birth certificate for USCIS. Show me the price.",
});

Herramientas exportadas: getCapabilities, quote, submit, getStatus, getResult, refund, verifyCertificate. Cada una es un Tool sencillo del AI SDK - desestructure si solo quiere un subconjunto. Los errores lanzan VerdacertHttpError con la envoltura de error estructurada y el id de la solicitud que devuelve el servidor.

¿Por qué AI Gateway? El mismo precio que el proveedor subyacente, conmutación por error entre múltiples proveedores, observabilidad, y el mismo id de modelo funciona en todos los hosts. En los despliegues de Vercel, AI_GATEWAY_API_KEY se inyecta automáticamente. Si prefiere llamar al proveedor directamente, cambie model: "anthropic/claude-sonnet-4" por model: anthropic("claude-sonnet-4-20250514") de @ai-sdk/anthropic.

¿Prefiere no agregar una dependencia? El paquete es una capa delgada sobre la API REST; consulte la sección REST más arriba para llamarla directamente. El servidor MCP en https://verdacert.com/api/mcp también es una opción para los clientes que usan herramientas y hablan MCP.

Uso de herramientas de OpenAI

La misma forma que el AI SDK - defina la herramienta con un esquema JSON y ejecútela vía REST. Esbozo:

const tools = [
  {
    type: "function",
    function: {
      name: "verdacert_quote",
      description: "Quote a Verdacert certified translation.",
      parameters: {
        type: "object",
        properties: {
          sourceLanguage: { type: "string" },
          useCase: { type: "string" },
          pageCount: { type: "integer", minimum: 1 },
          speedTier: { type: "string", enum: ["standard","express","rush","same_day"] }
        },
        required: ["sourceLanguage","useCase","pageCount","speedTier"]
      }
    }
  }
];

// Inside your tool_call handler:
async function verdacert_quote(args) {
  const res = await fetch("https://verdacert.com/api/v1/quote", {
    method: "POST",
    headers: {
      "content-type": "application/json",
      Authorization: `Bearer ${process.env.VERDACERT_API_KEY}`
    },
    body: JSON.stringify(args)
  });
  return res.json();
}

REST simple

Todos los endpoints de un vistazo:

Véalo en funcionamiento - agente de referencia

Un agente de IA completo y funcional que prepara traducciones de Verdacert para un expediente de inmigración vive en examples/immigration-paralegal en el repositorio de código abierto. Dos rutas de integración:

• Sin código: coloque el claude-desktop-config.json incluido en Claude Desktop, pegue la descripción de un caso y observe cómo Claude llama en secuencia a nuestras seis herramientas MCP.
• Programático: ~300 líneas de TypeScript con el Anthropic SDK + llamadas a herramientas. Haga un fork, sustituya la fuente de entrada de casos por el modelo de datos de su propio producto y lance.

# Programmatic path:
git clone https://github.com/mitrakmt/verdacert.git
cd verdacert/examples/immigration-paralegal
pnpm install
cp .env.example .env   # add VERDACERT_API_KEY + ANTHROPIC_API_KEY
pnpm start             # uses the sample I-130 case
# … or supply your own case file:
pnpm start path/to/case.md

3. Verifique un certificado

Cada resultado incluye un recibo JWS firmado con Ed25519. Obtenga la clave pública una vez, guárdela en caché durante una hora y verifique el JWS localmente - sin necesidad de llamarnos:

# JWKS (public keys)
curl https://verdacert.com/.well-known/jwks.json

# Single-cert JSON (also includes the JWS)
curl https://verdacert.com/api/v1/verify/<certificateId>

# Human-readable verification page (also linked from every PDF QR)
https://verdacert.com/verify/<certificateId>

4. Webhooks (opcional)

Olvídese del sondeo. Proporcione una URL de webhook al generar su clave (o por llamada mediante submit({ webhookUrl })) y Verdacert enviará por POST los eventos de cambio de estado. Las cargas van firmadas con HMAC al estilo de Stripe:

POST <your webhook URL>
content-type:           application/json
x-verdacert-event:      order.ready
x-verdacert-event-id:   evt_…
x-verdacert-signature:  t=<unix>,v1=<hex_hmac_sha256>

{
  "id": "evt_…",
  "type": "order.ready",
  "createdAt": "2026-05-22T18:00:00.000Z",
  "data": {
    "jobId": "…",
    "orderNumber": "VC-2026-…",
    "status": "ready",
    "apiKeyId": "…",
    "externalEndUserId": "your-user-id",
    "promisedDeliveryAt": "2026-05-23T18:00:00.000Z"
  }
}

Verifique v1 recalculando HMAC-SHA256(t + "." + body, webhookSecret) en tiempo constante. Rechace los eventos con más de ~5 minutos de antigüedad.

5. Obtenga una clave sandbox + prueba rápida

Escriba a hello@verdacert.com para obtener un token sandbox. La validación más rápida:

# 1. Capabilities
curl -H "Authorization: Bearer vc_sandbox_…" \
  https://verdacert.com/api/v1/capabilities

# 2. Quote
curl -X POST https://verdacert.com/api/v1/quote \
  -H "Authorization: Bearer vc_sandbox_…" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceLanguage":"fa","useCase":"uscis",
    "pageCount":2,"speedTier":"standard"
  }'

# 3. Submit (echo the quote input back)
# 4. Poll /api/v1/status/<jobId> until status === "ready"
# 5. Fetch /api/v1/result/<jobId>

El ciclo de vida completo del sandbox (paid → processing → in_review → ready) se completa en ~2 minutos; la revisión y certificación, en ~90 segundos.

Preguntas, alianzas, reparto de ingresos

hello@verdacert.com · lance una integración funcional y nosotros la acompañaremos después con un lanzamiento de marketing conjunto.