For AI agents
Plan an air dome with HeroX, from your agent
Everything an AI agent needs to research HeroX AirDomes, run our cost calculators and prepare a quote request: two MCP servers, 9 in-browser WebMCP tools, a sandbox quote API and machine-readable discovery files. No sign-up or API key is needed for any of it.
Ground rules
What agents can and can't do
You can
- Look up company facts, products, typical pricing, lead times, projects and articles.
- Run the ROI, OPEX, additional-costs and financing calculators as often as you like.
- Open pages on this site, including the booking calendar and checkout links, for the user.
- Validate quote requests against the sandbox quote API.
You must not
- Book a consultation or pick a time slot on the user's behalf. The user chooses it.
- Submit a live lead or quote request. Agents may only use the sandbox; send the user to the form.
- Complete a checkout. Purchase tools return a link and nothing is charged unless the user pays.
- Present calculator output as a quote. Final prices and terms come from a HeroX proposal.
Only pass a person's name, email or phone with their consent. See our privacy policy.
Model Context Protocol
MCP servers
HeroX AirDomes Product
- Endpoint
- https://www.heroxairdomes.com/api/mcp
- Transport
- Streamable HTTP (JSON-RPC 2.0), no auth
- Server card
- https://www.heroxairdomes.com/api/mcp/server-card
Product MCP server for HeroX AirDomes (air-supported domes and fabric structures). Use it to get company facts, list and start purchases of planning packages, book consultations, and run the ROI, OPEX, additional-costs and financing calculators (estimates, not quotes). For documentation and articles use the docs MCP server at https://www.heroxairdomes.com/api/docs-mcp.
HeroX AirDomes Docs
- Endpoint
- https://www.heroxairdomes.com/api/docs-mcp
- Transport
- Streamable HTTP (JSON-RPC 2.0), no auth
- Server card
- https://www.heroxairdomes.com/api/docs-mcp/server-card
Documentation MCP server for HeroX AirDomes. Use it to answer questions from reference docs and blog articles. It is read-only. To take actions (planning package purchases, booking a consultation) use the product MCP server at https://www.heroxairdomes.com/api/mcp.
MCP client config
Paste into your client's MCP settings (for example .mcp.json or mcp.json). No headers or keys needed.
{
"mcpServers": {
"herox-airdomes": {
"type": "http",
"url": "https://www.heroxairdomes.com/api/mcp"
},
"herox-airdomes-docs": {
"type": "http",
"url": "https://www.heroxairdomes.com/api/docs-mcp"
}
}
}Product server tools (9)
9 are read-only. Action tools never charge a card or contact anyone: they return links the user opens themselves. Inputs marked * are required.
| Tool | What it does | Inputs | Type |
|---|---|---|---|
| get_company_overview | Summary of HeroX AirDomes: applications, typical project budgets, sizes, lead times, options, warranty and financing. Use before answering any pricing or capability question. | none | Read-only |
| list_planning_packages | List the fixed-price planning packages a customer can buy online (concept sketch, renders, custom virtual tour, technician site visit) with IDs and USD prices. | none | Read-only |
| start_planning_package_purchase | Get the checkout link for a planning package so the user can pay securely on heroxairdomes.com. Does not charge anything; the user completes payment themselves. | package_id* | Read-only |
| book_consultation | Get the booking link for a free 1:1 product overview and ROI estimate call with the HeroX team. Use when the user wants a quote, a site-specific price, or to talk to sales. | topic | Read-only |
| list_site_pages | List the main pages of heroxairdomes.com with absolute URLs and what each page is for. | none | Read-only |
| calculate_dome_roi | Run the HeroX ROI calculator (https://www.heroxairdomes.com/resources/roi): payback period, 5- and 10-year ROI, net annual income and a 10-year cumulative cash flow. All money in USD. This is an estimate for planning purposes only, not a quote. | air_dome_cost_usd, additional_costs_usd, operational_costs_annual_usd, rented_hours_per_day, rent_per_hour_usd, operational_mode, annual_revenue_growth_percent | Read-only |
| estimate_dome_opex | Run the HeroX OPEX calculator (https://www.heroxairdomes.com/resources/opex): annual and monthly costs for fan/inflation, heating, cooling and lighting. Length, width and target temperature are always given in ft and °F (the page's slider values); unit_system only switches the page to metric display (€, m, °C) and its metric formula variant, exactly like the page. This is an estimate for planning purposes only, not a quote. | unit_system, length_ft, width_ft, energy_efficiency, climate, cooling_system, operational_mode, target_temp_f, daily_usage_hours, electricity_price_per_kwh, gas_price_per_kwh | Read-only |
| estimate_additional_costs | Run the HeroX Additional Costs Estimator (https://www.heroxairdomes.com/resources/additional-costs): foundation, permitting, site prep, utilities, cranes, workforce, HVAC and (US) general contracting costs beyond the dome itself. US results are in USD, Europe + Globally results in EUR. This is an estimate for planning purposes only, not a quote. | market, units, length, width | Read-only |
| estimate_financing_payment | Run the HeroX Financing Calculator (https://www.heroxairdomes.com/resources/financing): monthly payment, financed amount, total interest and total cost in USD. Assumes 10% down and 8% APR. Options from $0 down and rates from 5.99% depend on credit and project details. This is an estimate for planning purposes only, not a quote. | project_value_usd, term_months | Read-only |
estimate_financing_payment: Assumes 10% down and 8% APR. Options from $0 down and rates from 5.99% depend on credit and project details.
Docs server tools (5)
| Tool | What it does | Inputs | Type |
|---|---|---|---|
| list_docs | List HeroX AirDomes reference documents (company and product overview, agent skill, auth/access policy) with IDs and URLs. | none | Read-only |
| read_doc | Return the full Markdown text of a HeroX AirDomes reference document by ID from list_docs. | id* | Read-only |
| search_docs | Keyword search across HeroX AirDomes reference documents. Returns matching lines with their document ID. Use read_doc for full context. | query* | Read-only |
| list_blog_posts | List recent HeroX blog articles about air domes, fabric structures, costs and facility planning, with slugs for read_blog_post. | limit | Read-only |
| read_blog_post | Return the plain-text content of a HeroX blog article by slug from list_blog_posts. | slug* | Read-only |
In the browser
WebMCP tools
Every page registers these tools with navigator.modelContext when the browser supports WebMCP, so a browsing agent can call them directly instead of clicking through the UI. Action tools only navigate within this site.
| Tool | What it does | Inputs | Type |
|---|---|---|---|
| get_company_overview | Get a summary of HeroX AirDomes products, applications, typical pricing, lead times, options, and warranty. | none | Read-only |
| list_site_pages | List the main pages of the HeroX AirDomes website with their paths and purpose. | none | Read-only |
| navigate_to_page | Open a page of the HeroX AirDomes website in the current tab. | page* | Action |
| book_consultation | Open the scheduling page where the user can book a free 1:1 Zoom call for a product overview and ROI estimate. The user picks the time slot themselves. | none | Action |
| list_blog_posts | List recent HeroX blog articles about air domes, fabric structures, costs, and facility planning. | limit | Read-only |
| calculate_dome_roi | Run the HeroX ROI calculator (https://www.heroxairdomes.com/resources/roi): payback period, 5- and 10-year ROI, net annual income and a 10-year cumulative cash flow. All money in USD. This is an estimate for planning purposes only, not a quote. | air_dome_cost_usd, additional_costs_usd, operational_costs_annual_usd, rented_hours_per_day, rent_per_hour_usd, operational_mode, annual_revenue_growth_percent | Read-only |
| estimate_dome_opex | Run the HeroX OPEX calculator (https://www.heroxairdomes.com/resources/opex): annual and monthly costs for fan/inflation, heating, cooling and lighting. Length, width and target temperature are always given in ft and °F (the page's slider values); unit_system only switches the page to metric display (€, m, °C) and its metric formula variant, exactly like the page. This is an estimate for planning purposes only, not a quote. | unit_system, length_ft, width_ft, energy_efficiency, climate, cooling_system, operational_mode, target_temp_f, daily_usage_hours, electricity_price_per_kwh, gas_price_per_kwh | Read-only |
| estimate_additional_costs | Run the HeroX Additional Costs Estimator (https://www.heroxairdomes.com/resources/additional-costs): foundation, permitting, site prep, utilities, cranes, workforce, HVAC and (US) general contracting costs beyond the dome itself. US results are in USD, Europe + Globally results in EUR. This is an estimate for planning purposes only, not a quote. | market, units, length, width | Read-only |
| estimate_financing_payment | Run the HeroX Financing Calculator (https://www.heroxairdomes.com/resources/financing): monthly payment, financed amount, total interest and total cost in USD. Assumes 10% down and 8% APR. Options from $0 down and rates from 5.99% depend on credit and project details. This is an estimate for planning purposes only, not a quote. | project_value_usd, term_months | Read-only |
Sandbox only
Sandbox quote API
Add ?sandbox=1 (or the header X-HeroX-Sandbox: 1) to validate a quote request exactly as a live one would be, without creating a record in our CRM or contacting anyone. Sandbox responses carry X-HeroX-Sandbox: true and test IDs.
curl -X POST "https://www.heroxairdomes.com/api/pipedrive?sandbox=1" \
-H "Content-Type: application/json" \
-d '{"firstName":"Ada","lastName":"Test","contactEmail":"ada@example.com",
"city":"Austin","country":"US","widthMeters":36,"lengthMeters":60}'- Required fields
- firstName, lastName, contactEmail, city, country, widthMeters, lengthMeters
- Optional fields
- contactPhone, heightMeters, anchoringType, timeline, buyerStage, projectNotes, market, application, options
GET /api/pipedrive?sandbox=1 returns the same field list as JSON.
Validation errors (422)
A missing required field, a non-numeric size or a body that isn't a JSON object returns 422 with an errors array. A valid sandbox request returns 200 with test IDs. Requests without the sandbox flag are rejected.
HTTP/1.1 422 Unprocessable Entity
X-HeroX-Sandbox: true
{ "sandbox": true, "success": false,
"errors": ["lengthMeters is required", "widthMeters must be a number"] }Machine-readable
Discovery files
- /llms.txtPlain-text guide to the site for language models
- /.well-known/mcp.jsonMCP server index with endpoints and server cards
- /.well-known/api-catalogRFC 9727 API catalog (linkset)
- /.well-known/ard.jsonAgentic Resource Discovery manifest
- /.well-known/agent-skills/herox-airdomes/SKILL.mdAgent skill: how to help a user with HeroX