Aginera

Tools provided

Tools the agent exposes — your AI client calls them automatically when it needs them.

• get_capabilities — What Aginera does (takeoff, routing, schedules, estimating), example requests, environment, billing mode, enabled products, disciplines, export formats, limits and available credits. Call this first.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• search_projects — Find projects by name, reference, your customer identifier, or list the most recent ones. Use before creating a project to avoid duplicates.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_project — One project with its document count and references.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• create_project — Create a project to hold drawings and takeoffs.

  write

  runs when your client calls it …ran · ✓ done
• add_document — Import a drawing set into a project from an HTTPS URL (PDF, DWG, DXF; ≤ 50 MB). Ingestion is asynchronous: poll get_document until status is "ready" before running a takeoff. Free. API docs: https://aginera.ai/docs/developer/rest-quickstart (same operation as POST /partner/v1/documents).

  writeopen internet

  runs when your client calls it …ran · ✓ done
• list_documents — Documents in a project, optionally filtered by status; "latest" returns only the newest.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_document — Readiness, page count and per-sheet info (sheet number, whether a text layer exists).

  writeidempotent

  runs when your client calls it …ran · ✓ done
• run_takeoff — Start a quantity takeoff on a ready document for one discipline (or multi_discipline). Places a credit hold for the maximum plausible cost; the final charge never exceeds it. Returns immediately with status "queued"; poll get_takeoff until "completed" (typically 3–20 minutes depending on pages). Ask the user before running if cost matters.

  write

  runs when your client calls it …ran · ✓ done
• list_takeoffs — Existing takeoffs for a project or document, newest first — including completed takeoffs the user ran in the Aginera web app (origin "web_app"). Each has its id (tko_…), document, discipline, status, created/completed times and, when completed, item/sheet/route counts and credits charged. Call this before run_takeoff: if a completed takeoff already exists, read it with get_takeoff_items / get_takeoff_routes / get_schedules instead of paying for a new run. Give project_id or document_id (or both)

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_takeoff — Status, progress, queue position, warnings and — when completed — item/sheet/route counts and credits charged.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_takeoff_items — Extracted scope for a completed takeoff. Filter by trade, category, item type, page or review status; consolidate identical items across sheets; choose units. Paginate with cursor. Returns structured items plus totals by category.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_takeoff_routes — Measured runs (conduit, feeder, branch circuit, cable tray, duct, pipe) with quantities, endpoints and page geometry, plus totals by system. Requires a completed takeoff.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_schedules — Panel, fixture, equipment and other schedules detected in a completed takeoff, as structured rows.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• review_takeoff_item — Accept, reject or override the quantity of an item. The extracted quantity is preserved; your override becomes the effective quantity.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• create_export — Export a completed takeoff as CSV, Excel (xlsx) or JSON. Returns a time-limited download link.

  write

  runs when your client calls it …ran · ✓ done
• get_usage — Credit balance (in credits) and usage for a date range, grouped by day, operation, client, user, surface or end customer.

  writeidempotent

  runs when your client calls it …ran · ✓ done
• delete_project — Permanently delete a project and all of its documents and takeoffs. Always confirm with the user first.

  destructiveidempotent

  runs when your client calls it …ran · ✓ done
• delete_document — Permanently delete a document and its takeoffs. Always confirm with the user first.

  destructiveidempotent

  runs when your client calls it …ran · ✓ done
• convert_pdf_to_cad — Check whether a PDF drawing in a project can be converted to editable CAD (DWG/DXF) and what it costs this user — the same converter and prices as aginera.ai/tools/pdf-to-cad. Vector PDFs convert line-for-line; scans are traced. Pricing: DXF of every sheet is free (watermarked on free accounts); a clean DWG is a one-time $2 purchase per document (or credits for paying customers); files over 50 MB are part of that purchase; paid plans are not charged. Does not convert or charge anything. Add the

  writeidempotent

  runs when your client calls it …ran · ✓ done
• get_cad_file — Convert a ready PDF document and return a time-limited download link (valid ~60 minutes) for the DXF or DWG. Conversion can take up to ~3 minutes for large sets. DXF (default) is free for everyone — watermarked on free accounts. DWG, or any file over 50 MB, is a one-time $2 purchase per document: without `pay` this returns status "purchase_required" with the price and nothing is charged. Only after the user explicitly agrees to pay: pay="credits" pays the $2 from their Aginera credits (paying cu

  writeidempotentopen internet

  runs when your client calls it …ran · ✓ done