Verdacert API

1. Get a key

Self-serve at verdacert.com/onboarding. Sign in, name your firm, mint a sandbox key. Live keys unlock the moment you add a default payment method - no waitlist, no sales call.

Sandbox keys look like:  vc_sandbox_p7q8r…       (free, synthetic flow)
Live keys look like:     vc_live_abc123…         (real orders, real money)

2a. Curl path

Health-check capabilities, then quote - that's your full wire test:

# Live enums you can call with
curl https://verdacert.com/api/v1/capabilities \
  -H "Authorization: Bearer vc_sandbox_…"

# Binding price + ETA 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"
  }'

2b. Vercel AI SDK path

One import gives any AI SDK call all seven tools, typed and ready:

pnpm add @verdacert/ai-sdk-tools ai zod

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

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

const { text } = await generateText({
  // Routes through Vercel AI Gateway automatically when
  // AI_GATEWAY_API_KEY is present (auto-injected on Vercel).
  model:     "anthropic/claude-sonnet-4",
  tools,
  stopWhen:  stepCountIs(20),
  prompt:    "Quote a 3-page Farsi birth certificate for USCIS.",
});

2c. MCP path (Claude Desktop, Cursor, …)

Drop this into ~/Library/Application Support/Claude/claude_desktop_config.json (or your client's equivalent) and restart:

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

All seven tools (capabilities, quote, submit, status, result, refund, verify) show up in your client's tool picker immediately.