Verdacert کو 5 منٹ میں کسی بھی AI ایجنٹ میں شامل کریں

1. ایک sandbox ٹوکن حاصل کریں (60 سیکنڈ، کوئی فہرستِ انتظار نہیں)

خود خدمتی verdacert.com/onboarding پر۔ اپنے ای میل سے سائن ان کریں، اپنی فرم کا نام رکھیں، ایک sandbox کلید بنائیں — مکمل۔ جیسے ہی آپ کوئی پہلے سے طے شدہ ادائیگی کا طریقہ شامل کرتے ہیں لائیو کیز کھل جاتی ہیں؛ کوئی انسانی منظوری کا دروازہ نہیں۔

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

2. اپنے انضمام کی شکل منتخب کریں

MCP — Claude Desktop، Cursor، ایجنٹک فریم ورکس

Verdacert سات ٹولز کے ساتھ ایک streamable-HTTP MCP سرور فراہم کرتا ہے: get_capabilities, quote, submit, get_status, get_result, refund, verify_certificate۔ کسی بھی MCP کلائنٹ کو https://verdacert.com/api/mcp کی طرف اپنے bearer ٹوکن کے ساتھ متوجہ کریں۔

Claude Desktop کنفیگ

~/Library/Application Support/Claude/claude_desktop_config.json میں شامل کریں (یا اپنے OS پر اس کے مساوی):

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

Cursor MCP کنفیگ

Settings ← MCP ← Add new MCP server۔ وہی JSON جیسے اوپر۔

پروگرامی JSON-RPC (کوئی بھی 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

ایک import آپ کو ساتوں ٹولز دیتا ہے، قسم‌بند اور آپ کے generateText / streamText / ایجنٹ کال میں ڈالنے کے لیے تیار۔ بطورِ @verdacert/ai-sdk-tools شائع شدہ۔

انسٹال

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

استعمال (Vercel AI Gateway کے ساتھ — تجویز کردہ)

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

برآمد شدہ ٹولز: getCapabilities, quote, submit, getStatus, getResult, refund, verifyCertificate۔ ہر ایک ایک سادہ AI SDK Tool ہے — اگر آپ صرف ایک ذیلی مجموعہ چاہتے ہیں تو اسے ڈی اسٹرکچر کریں۔ خطائیں VerdacertHttpError پھینکتی ہیں، سرور سے ساختہ خطا لفافے اور درخواست id کے ساتھ۔

AI Gateway کیوں؟ بنیادی فراہم کنندہ جیسی ہی قیمت، کئی فراہم کنندگان میں ناکامی کا متبادل، مشاہدہ پذیری، اور وہی ماڈل id میزبانوں کے آر پار کام کرتا ہے۔ Vercel تعیناتیوں پر، AI_GATEWAY_API_KEY خودکار طور پر داخل ہوتا ہے۔ اگر آپ فراہم کنندہ کو براہِ راست کال کرنا چاہیں، تو model: "anthropic/claude-sonnet-4" کو model: anthropic("claude-sonnet-4-20250514") سے @ai-sdk/anthropic سے بدل دیں۔

انحصار شامل نہ کرنا چاہتے ہیں؟ پیکج REST API کے گرد ایک پتلا لپیٹ ہے؛ اسے براہِ راست کال کرنے کے لیے اوپر کا REST سیکشن دیکھیں۔ https://verdacert.com/api/mcp پر MCP سرور بھی MCP بولنے والے ٹول استعمال کرنے والے کلائنٹس کے لیے ایک آپشن ہے۔

OpenAI ٹول کا استعمال

AI SDK جیسی ہی شکل — ٹول کو ایک JSON اسکیمہ سے بیان کریں اور REST کے ذریعے چلائیں۔ خاکہ:

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"] }
        },
        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

ہر اینڈ پوائنٹ ایک نظر میں:

اسے کام کرتے دیکھیں — حوالہ ایجنٹ

ایک مکمل کارآمد AI ایجنٹ جو امیگریشن کیس فائل کے لیے Verdacert تراجم تیار کرتا ہے، اوپن سورس ریپو میں examples/immigration-paralegal پر موجود ہے۔ انضمام کے دو راستے:

• کوئی کوڈ نہیں: شامل کردہ claude-desktop-config.json کو Claude Desktop میں ڈالیں، ایک کیس کی تفصیل پیسٹ کریں، اور Claude کو ہمارے چھ MCP ٹولز ترتیب وار کال کرتے دیکھیں۔
• پروگرامی: Anthropic SDK + ٹول کالنگ کے ساتھ تقریباً 300 سطریں TypeScript۔ اسے فورک کریں، کیس انٹیک ماخذ کو اپنی مصنوعہ کے ڈیٹا ماڈل سے بدلیں، اور پیش کریں۔

# 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. ایک سند کی تصدیق کریں

ہر نتیجہ Ed25519 سے دستخط شدہ ایک JWS رسید رکھتا ہے۔ عوامی کلید ایک بار حاصل کریں، ایک گھنٹے کے لیے کیش کریں، JWS کو مقامی طور پر تصدیق کریں — ہمیں کال کرنے کی ضرورت نہیں:

# 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. ویب ہکس (اختیاری)

پولنگ چھوڑیں۔ اپنی کلید بناتے وقت ایک ویب ہک URL فراہم کریں (یا فی کال submit({ webhookUrl }) کے ذریعے) اور Verdacert حالت بدلنے والے واقعات POST کرے گا۔ پے لوڈز Stripe طرز پر HMAC سے دستخط شدہ ہیں:

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"
  }
}

v1 کو HMAC-SHA256(t + "." + body, webhookSecret) کو مستقل وقت میں دوبارہ شمار کر کے تصدیق کریں۔ تقریباً 5 منٹ سے پرانے واقعات مسترد کریں۔

5. ایک sandbox کلید + اسموک ٹیسٹ حاصل کریں

ایک sandbox ٹوکن کے لیے hello@verdacert.com پر ای میل کریں۔ تیز ترین توثیق:

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

مکمل sandbox دورانیۂ حیات (paid ← processing ← in_review ← ready) تقریباً 2 منٹ میں مکمل ہوتا ہے؛ نظرثانی اور تصدیق تقریباً 90 سیکنڈ میں۔

سوالات، شراکتیں، آمدنی میں حصہ

hello@verdacert.com · ایک کارآمد انضمام پیش کریں اور ہم ایک مشترکہ مارکیٹنگ والی لانچ کی پشت پناہی کریں گے۔