Connect to ChatGPT or Claude

Add Aginera as an MCP server and run takeoffs from a conversation.

Aginera MCP is a remote MCP server at https://mcp.aginera.ai/mcp. Add it once to your agent, sign in to Aginera, choose your organization and approve the permissions — refresh tokens keep the connection alive, so you only do this once.

Claude

Claude connects to Aginera as a custom connector over remote MCP (Streamable HTTP + OAuth).

Claude Desktop / claude.ai

  1. Settings → Connectors → Add custom connector.
  2. Name it Aginera and set the URL to https://mcp.aginera.ai/mcp.
  3. Save, then click Connect — Claude opens Aginera's sign-in in your browser.
  4. Sign in, pick your organization, and Allow the permissions shown. You're returned to Claude.
  5. Aginera's tools now appear in the connector. Ask, e.g. "Take off the electrical scope from the latest drawing set for the Marriott project and summarize conduit by panel."

Claude Code (CLI)

claude mcp add --transport http aginera https://mcp.aginera.ai/mcp

Then run any Aginera prompt; Claude Code opens the browser sign-in on first use.

ChatGPT

ChatGPT connects to Aginera as a custom MCP app (Developer mode / Plugins → Connectors).

  1. Settings → Plugins → New (the ＋ in the plugins panel).
  2. Name Aginera; Description "Turn construction drawings into takeoffs, measured routes and schedules."
  3. Connection: leave Server URL selected and enter https://mcp.aginera.ai/mcp.
  4. Authentication: choose OAuth — Aginera's settings are discovered automatically (open Advanced OAuth settings to review scopes).
  5. Read the custom-server notice, tick I understand and want to continue, and click Create.
  6. Sign in to Aginera, choose your organization, and Allow the scopes.
  7. The Aginera app now lists its Actions (add_document, run_takeoff, …). Write actions (running takeoffs, exports) require a plan that allows them.

GitHub Copilot / VS Code

VS Code speaks MCP as well. Add a server in .vscode/mcp.json:

{
  "servers": {
    "aginera": { "type": "http", "url": "https://mcp.aginera.ai/mcp" }
  }
}

Reload the window; Copilot Chat in agent mode prompts the OAuth sign-in on first use, then exposes Aginera's tools.

What the tools do

ToolPurpose
search_projects, get_project, create_projectFind or create projects by name, reference or your customer
add_document, list_documents, get_documentImport drawings by URL and check readiness
run_takeoff, get_takeoffStart a takeoff (uses credits) and follow progress
get_takeoff_items, get_takeoff_routes, get_schedulesRead quantities, measured routes and schedules
review_takeoff_itemAccept, reject or override an item
create_exportCSV / Excel / JSON
convert_pdf_to_cad, get_cad_fileConvert a PDF drawing to CAD — DXF of every sheet free (aginera.ai watermark), clean DWG $2 per drawing
render_floor_plan, get_floor_plan_renderTurn a floor-plan PDF into a furnished 3D dollhouse, a rendered floor plan and room images (uses credits; 5–15 min)
get_floor_plan_renders, create_render_checkoutA project's images and the optional add-ons — every room $5, house film $19, dollhouse remix $2 — as a payment link you complete
get_usage, get_capabilitiesCredits, limits and what your account can do

Try: "Take off the electrical scope from the latest drawing set for the Marriott project and summarize conduit by panel."

Or: "Convert this PDF floor plan to DWG." The agent adds the PDF with add_document, waits for it to be ready, calls convert_pdf_to_cad to check it converts (and what it costs), then get_cad_file. Asking for format: "dxf" returns a free, watermarked DXF link. A clean DWG costs $2: with pay: "credits" it is paid from the account's credits; with pay: "checkout" the agent returns a Stripe link that you complete. The agent should always ask you before paying.

Or: "Turn this floor plan into a 3D dollhouse." The agent adds the PDF with add_document, starts render_floor_plan, and polls get_floor_plan_render about once a minute; in 5–15 minutes it returns links to the dollhouse, the rendered floor plan and room images — the same reveal the web app shows. get_floor_plan_renders lists everything rendered for a project plus the add-ons; create_render_checkout returns a Stripe link that you complete.

Connected before October 18, 2026? The floor-plan tools need two extra permissions (interior:read, interior:generate). The first time the agent uses one it asks you to reconnect Aginera; approve the new permissions once.

Permissions and billing

You grant scopes on the consent screen; billable tools (running takeoffs, floor-plan renders, exports in some formats) are annotated so the agent asks before spending credits. Usage on your Aginera account is billed exactly as if you had clicked the same action in the web app. Disconnect at any time from Settings → Developer → Agent connections.