Mete Verdacert nan nenpòt ajan AI nan 5 minit

1. Jwenn yon token sandbox (60 segonn, san lis datant)

Fè l pou kont ou sou verdacert.com/onboarding. Konekte ak imèl ou, bay konpani ou an yon non, kreye yon kle sandbox - fini. Kle an dirèk yo aktive kou ou ajoute yon metòd peman pa defo; san okenn etap apwobasyon pa yon moun.

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

2. Chwazi fòm entegrasyon ou a

MCP - Claude Desktop, Cursor, framework ajan yo

Verdacert bay yon sèvè MCP streamable-HTTP ak sèt zouti: get_capabilities, quote, submit, get_status, get_result, refund, verify_certificate. Pwente nenpòt kliyan MCP sou https://verdacert.com/api/mcp ak token bearer ou a.

Konfigirasyon Claude Desktop

Ajoute sa nan ~/Library/Application Support/Claude/claude_desktop_config.json (oswa ekivalan an sou sistèm operasyon ou a):

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

Konfigirasyon MCP nan Cursor

Settings → MCP → Add new MCP server. Menm JSON ki anwo a.

JSON-RPC pwogramatik (nenpòt kliyan 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

Yon sèl import ba ou tout sèt zouti yo, ak tip epi pare pou antre nan apèl generateText / streamText / ajan ou a. Pakè a pibliye kòm @verdacert/ai-sdk-tools.

Enstalasyon

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

Itilizasyon (ak Vercel AI Gateway - rekòmande)

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.",
});

Zouti nou ekspòte yo: getCapabilities, quote, submit, getStatus, getResult, refund, verifyCertificate. Chak se yon senp Tool AI SDK - dekonpoze yo si ou vle sèlman yon pati. Erè yo lanse VerdacertHttpError ak anvlòp erè estriktire a ansanm ak id demann lan ki soti nan sèvè a.

Poukisa AI Gateway? Menm pri ak founisè debaz la, li chanje otomatikman sou yon lòt founisè si youn tonbe, obsèvabilite, epi menm id modèl la mache sou tout platfòm yo. Nan deplwaman sou Vercel, AI_GATEWAY_API_KEY enjekte otomatikman. Si ou pito rele founisè a dirèkteman, ranplase model: "anthropic/claude-sonnet-4" ak model: anthropic("claude-sonnet-4-20250514") ki soti nan @ai-sdk/anthropic.

Ou pito pa ajoute yon depandans? Pakè a se yon ti kouch mens sou API REST la; gade seksyon REST ki anwo a pou rele li dirèkteman. Sèvè MCP ki sou https://verdacert.com/api/mcp se yon opsyon tou pou kliyan ki sèvi ak zouti epi ki pale MCP.

Itilizasyon zouti OpenAI

Menm fòm ak AI SDK a - defini zouti a ak yon schema JSON epi egzekite l atravè REST. Yon apèsi:

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 senp

Tout endpoint yo yon sèl kout je:

Gade l k ap mache - ajan referans

Yon ajan AI konplè k ap mache, ki prepare tradiksyon Verdacert pou yon dosye ka imigrasyon, disponib nan examples/immigration-paralegal nan repo open-source la. De chemen entegrasyon:

• San kòd: mete fichye claude-desktop-config.json nou bay la nan Claude Desktop, kole yon deskripsyon ka, epi gade Claude k ap rele sis zouti MCP nou yo youn apre lòt.
• Pwogramatik: Anviwon 300 liy TypeScript ki sèvi ak Anthropic SDK + apèl zouti. Fè yon fork, ranplase sous done ka a ak modèl done pwodui pa ou a, epi lanse.

# 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. Verifye yon sètifika

Chak rezilta vini ak yon resi JWS ki siyen ak Ed25519. Chèche kle piblik la yon sèl fwa, kenbe l nan cache pou yon èdtan, epi verifye JWS la lokalman - ou pa bezwen rele nou:

# 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. Webhook (opsyonèl)

Pa bezwen fè polling. Bay yon URL webhook lè w ap kreye kle ou a (oswa pou chak apèl atravè submit({ webhookUrl })) epi Verdacert ap voye evènman chanjman eta yo an POST. Payload yo siyen ak HMAC nan estil 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"
  }
}

Verifye v1 lè ou rekalkile HMAC-SHA256(t + "." + body, webhookSecret) nan tan konstan. Rejte evènman ki pi ansyen pase ~5 minit.

5. Jwenn yon kle sandbox + yon tès rapid

Voye yon imèl bay hello@verdacert.com pou jwenn yon token sandbox. Validasyon ki pi rapid la:

# 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>

Tout sik lavi sandbox la (paid → processing → in_review → ready) fini nan ~2 minit; revizyon ak sètifikasyon an nan ~90 segonn.

Kesyon, patenarya, pataj revni

hello@verdacert.com · lanse yon entegrasyon k ap mache epi n ap fè yon lansman maketing ansanm avè w.