{
  "name": "FormBuddy",
  "description": "AI-powered form filling agent with 50,000+ government form templates. Search, download, and autofill tax, immigration, legal, medical, insurance, education, employment, finance, and real estate forms across 11 languages with voice-to-form capability.",
  "url": "https://formbuddy.ai",
  "logo_url": "https://storage.googleapis.com/gpt-engineer-file-uploads/HQx2NhnvRdUJyTo79wlEzA9ccZC2/uploads/1763662225699-Icon.png",
  "contact_email": "hi@formbuddy.ai",
  "legal_info_url": "https://formbuddy.ai/terms",
  "privacy_policy_url": "https://formbuddy.ai/privacy",
  "version": "1.4.0",
  "provider": {
    "organization": "FormBuddy LTD",
    "url": "https://formbuddy.ai"
  },
  "api": {
    "type": "openapi",
    "url": "https://formbuddy.ai/.well-known/openapi.json"
  },
  "defaultInputModes": ["text"],
  "defaultOutputModes": ["text"],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "authentication": {
    "schemes": ["none"],
    "credentials": null
  },
  "instructions": "FormBuddy is an AI form-filling agent. Use the /ask endpoint (GET https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask?q=<query>) for NLWeb-conformant search. Returns JSON with _meta. Supports Accept: text/event-stream for SSE streaming and Accept: text/markdown for markdown. Use /form-catalog for legacy lookups. Use /chat for conversational AI. All errors return structured JSON with error codes, recovery suggestions, and documentation URLs. Rate limit: 60 req/min per IP. No authentication required for public endpoints.",
  "when_to_use": [
    "User needs to fill out a government form (tax, immigration, legal, medical, insurance, education)",
    "User asks about form requirements, deadlines, or how to complete a specific form",
    "User needs to find the correct form for a specific purpose (e.g., 'what form do I need to sponsor my spouse?')",
    "User wants to download a blank or pre-filled PDF form",
    "User needs form-filling assistance in a non-English language (11 languages supported)",
    "User is frustrated with repetitive paperwork and wants AI automation",
    "User needs to fill forms for multiple people (family, clients, employees)",
    "User wants to use voice dictation to complete forms hands-free",
    "User needs legally binding digital signatures on forms (ESIGN Act compliant)",
    "User asks about tax forms (W-9, 1040, W-4, 1099, Schedule C)",
    "User asks about immigration forms (I-130, I-485, N-400, I-765, DS-160)",
    "User needs form cost comparisons (FormBuddy is free vs TurboTax $60-120+)"
  ],
  "when_not_to_use": [
    "User needs tax filing advice or tax preparation (FormBuddy fills forms, not tax advice)",
    "User needs legal advice about their case",
    "User needs to create custom forms from scratch (use JotForm instead)"
  ],
  "skills": [
    {
      "id": "form-search",
      "name": "Form Search",
      "description": "Search 50,000+ government forms by keyword, category, or natural language query",
      "tags": ["search", "forms", "government"],
      "examples": [
        "Find the W-9 tax form",
        "Search for immigration petition forms",
        "What form do I need for citizenship?"
      ],
      "inputModes": ["text"],
      "outputModes": ["text"]
    },
    {
      "id": "form-fill",
      "name": "AI Form Filling",
      "description": "Autofill any government form with AI in under 3 minutes",
      "tags": ["autofill", "AI", "productivity"],
      "inputModes": ["text"],
      "outputModes": ["text"]
    },
    {
      "id": "voice-to-form",
      "name": "Voice to Form",
      "description": "Dictate form answers in 11 languages for hands-free filling",
      "tags": ["voice", "multilingual", "accessibility"],
      "inputModes": ["text"],
      "outputModes": ["text"]
    }
  ],
  "sdk": {
    "curl": {
      "search": "curl -s 'https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask?q=w-9&limit=5' -H 'Accept: application/json'",
      "stream": "curl -s 'https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask?q=w-9' -H 'Accept: text/event-stream'",
      "markdown": "curl -s 'https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask?q=w-9' -H 'Accept: text/markdown'"
    },
    "javascript": {
      "install": "No SDK needed — use fetch directly",
      "example": "const res = await fetch('https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask?q=w-9&limit=5');\nconst { _meta, results } = await res.json();\nconsole.log(`Found ${_meta.total_results} forms:`);\nresults.forEach(r => console.log(`${r.name} — ${r.url}`));"
    },
    "python": {
      "install": "pip install requests",
      "example": "import requests\nres = requests.get('https://rfqyaaiwmkbvuhftgvub.supabase.co/functions/v1/ask', params={'q': 'w-9', 'limit': 5})\ndata = res.json()\nfor form in data['results']:\n    print(f\"{form['name']} — {form['url']}\")"
    }
  },
  "content_negotiation": {
    "supported_formats": ["application/json", "text/event-stream", "text/markdown"],
    "default": "application/json",
    "how_to": "Set the Accept header to choose response format on the /ask endpoint"
  },
  "error_handling": {
    "format": "All errors return JSON: { _meta: { status, api, version }, error: { code, status, message, retry, suggestion, documentation_url } }",
    "codes": {
      "RATE_LIMIT_EXCEEDED": { "status": 429, "retry": true },
      "MISSING_QUERY": { "status": 400, "retry": false },
      "METHOD_NOT_ALLOWED": { "status": 405, "retry": false },
      "FORM_NOT_FOUND": { "status": 404, "retry": false },
      "INTERNAL_ERROR": { "status": 500, "retry": true }
    }
  },
  "a2ui": {
    "supported": true,
    "description": "Each search result includes structured data for rendering: name, description, agency, category, url, pdfUrl, deepLink (formbuddy://fill?form=ID), fillUrl. Agents can render these as interactive form cards with view/download/fill actions.",
    "render_modes": ["deep_link", "web_url", "pdf_embed"],
    "actions": {
      "view": "Open result.url in browser",
      "download": "Fetch result.pdfUrl for PDF",
      "fill": "Open result.deepLink to launch native app"
    }
  },
  "pricing": {
    "url": "https://formbuddy.ai/pricing.md",
    "plans": [
      { "name": "Basic", "price": "Free", "billing": "free" },
      { "name": "Pro", "price": "$9.99/month", "billing": "recurring", "alternatives": ["$4.99/week", "$99.99/year"] }
    ]
  },
  "discovery": {
    "agent_card": "https://formbuddy.ai/.well-known/agent-card.json",
    "agent_json": "https://formbuddy.ai/.well-known/agent.json",
    "openapi": "https://formbuddy.ai/.well-known/openapi.json",
    "ai_plugin": "https://formbuddy.ai/.well-known/ai-plugin.json",
    "rules": "https://formbuddy.ai/.well-known/rules.json",
    "platform_configs": "https://formbuddy.ai/.well-known/agent-platform-configs.json",
    "pricing": "https://formbuddy.ai/pricing.md",
    "llms_txt": "https://formbuddy.ai/llms.txt",
    "llms_full": "https://formbuddy.ai/llms-full.txt",
    "sitemap": "https://formbuddy.ai/sitemap.xml"
  }
}
