plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "clevra",
  "version": "1.0.6",
  "description": "Clevra field service management: read jobs, schedule, invoices, estimates, clients and reports, and take six everyday actions, as the signed-in user.",
  "author": {
    "name": "Clevra Inc.",
    "email": "hi@clevra.ai",
    "url": "https://clevra.ai"
  },
  "homepage": "https://clevra.ai",
  "keywords": [
    "field service",
    "scheduling",
    "invoices",
    "estimates",
    "crm"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Clevra",
        "shortDescription": "Field service jobs & schedule",
        "longDescription": "Use ChatGPT to run your field service business in Clevra: check the schedule, follow up on overdue invoices and estimates, look up clients and jobs, run business reports, book visits and draft estimates, all from a chat.\n\nClevra is AI field service software that runs every job from call to invoice. It's built for technical field trades like subsurface scanning, utility locating, and inspection, and for HVAC, plumbing, electrical, cleaning, landscaping, and 50+ other trades. In Clevra, crews record findings, readings, and photos on site with checklists attached to each visit, so the office, the client's report, and the invoice all work from the same field record.\n\nClevra is built AI-first. Alongside its own AI assistant, the Clevra app lets ChatGPT work with your company's Clevra data, always as you and within exactly what your Clevra role allows.\n\nAsk in plain language about today's schedule, which invoices are overdue, what a client has been quoted, how a job performed or what last month's invoices report shows. ChatGPT can read clients and client notes, a client's billing standing, jobs and job statistics, job profit where your role can see costing, invoices, estimates, requests, the schedule, open time slots for a technician, activities, your team and the reports available to you.\n\nChatGPT can also take six everyday actions: create a client, add a client note, log an activity, create a task, draft an estimate, and schedule a visit. You choose in ChatGPT's settings when it asks before using them. Every action runs through the same rules as the Clevra app and is recorded in Clevra's audit trail. Scheduling a visit sends your company's usual automatic messages, exactly as booking in Clevra does.\n\nThe app never sends emails or texts on its own, takes payments, deletes records, converts estimates, or changes billing, payroll, team membership or company settings.\n\nAdmins stay in control from Settings \u2192 Connected apps: see every connection, disconnect anyone, pause all connections, or make connections read-only for the whole company. Clevra never receives your conversations; it keeps only a content-free access record of each request, for 90 days.\n\nRequires a Clevra account with the Org Admin, Manager or Dispatcher role, in a company where the Clevra AI assistant is turned on.",
        "developerName": "Clevra Inc.",
        "category": "Business & Operations",
        "capabilities": [
          "Read schedule, jobs, invoices, estimates and clients",
          "Run business reports",
          "Book visits and draft estimates"
        ],
        "websiteURL": "https://clevra.ai",
        "supportURL": "https://clevra.ai/contact",
        "privacyPolicyURL": "https://clevra.ai/privacy",
        "termsOfServiceURL": "https://clevra.ai/terms-of-service",
        "defaultPrompt": [
          "What's on the schedule next week?",
          "Which invoices are overdue?",
          "Show me last month's invoices report."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Schedule for fixed dates",
              "prompt": "What's on the schedule from October 7 to October 9, 2026?",
              "tools_triggered": "get_schedule",
              "expected_behavior": "Lists the two scheduled visits in the company's timezone (Pacific): Wed Oct 7, 2026, 8:00-11:00 AM, Split system AC service (3 units) for Greenpoint Coworking, and Thu Oct 8, 2026, 6:00-9:00 PM, Water heater replacement for Sunrise Daycare Center, both assigned to Clevra Test. Nothing is scheduled on Oct 9."
            },
            {
              "description": "One job with its visits",
              "prompt": "Show me job JOB-0008: the client, its visits and who is assigned.",
              "tools_triggered": "get_job",
              "expected_behavior": "JOB-0008 Water heater replacement for Sunrise Daycare Center, with two separate visits, Thu Oct 8, 2026, 6:00-9:00 PM and Wed Oct 14, 2026, 6:00-7:00 PM, both assigned to Clevra Test."
            },
            {
              "description": "One invoice and what is still owed",
              "prompt": "Show me invoice INV-2026-0001: the client, the due date and how much is still owed.",
              "tools_triggered": "get_invoice",
              "expected_behavior": "Invoice INV-2026-0001 for Hudson Yards Dental Group, due Sep 19, 2026, with $593.00 still owed; the invoice is overdue."
            },
            {
              "description": "A technician's free time",
              "prompt": "Find Marcus Rivera on my team, then tell me when he's free for a 2-hour job between January 11 and January 15, 2027.",
              "tools_triggered": "list_team_members, find_open_slots",
              "expected_behavior": "Looks up Marcus Rivera, then reports him free every weekday from Mon Jan 11 to Fri Jan 15, 2027, 9:00 AM-5:00 PM Pacific; a 2-hour job can start as late as 3:00 PM. Nothing is booked."
            },
            {
              "description": "A business report for one month",
              "prompt": "Show me the invoices report for October 2026.",
              "tools_triggered": "run_invoices_report",
              "expected_behavior": "Runs the Invoices report for Oct 1-31, 2026 by issue date and gives the same tiles and totals as Reports > Invoices in Clevra for those dates, including $2,371.00 still owed (Awaiting payment plus Past due)."
            }
          ],
          "negative": [
            {
              "description": "Unrelated question. Expected: ChatGPT answers on its own and the Clevra app is not called; Clevra has no weather data.",
              "prompt": "What's the weather in Vancouver tomorrow?"
            },
            {
              "description": "Creative writing. Expected: ChatGPT writes the poem itself and the Clevra app is not called.",
              "prompt": "Write a short poem about a plumber's busy day."
            },
            {
              "description": "Hiring is outside the app. Expected: ChatGPT writes the job posting itself and the Clevra app is not called; the app has no hiring or team tools.",
              "prompt": "Write a job posting for an HVAC technician."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Clevra does not sell products or process payments through ChatGPT.",
        "demo_recording_url": "https://drive.google.com/file/d/1jk9Du_xmQKOGxUvuVWv8mathpa5U7zdc/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Initial release: 39 read tools, including 21 business reports, and 6 confirmed write actions over Clevra's own API."
      },
      "apps": "./.app.json"
    }
  }
}