ARUON Research — ordering by API and MCP

How a program or an AI agent orders an ARUON Research report. Every order goes through the same door as the order form on reir.aruon.ai, and the same people are in it.

Weekly maintenance: Tuesdays from 1:00 AM Central for up to about 45 minutes, reir.aruon.ai may not answer. Orders and payments are never lost; if a request fails then, retry after 1:45 AM Central.

What a program can and cannot do

It can read the catalog and prices, check coverage for a place, place an order and read the order's status.
It cannot pay, start a report or release one. HubSpot takes payment on its own checkout page. After payment an analyst gives the go-ahead, and an analyst releases every report. Nothing is auto-sent.
An order returns a checkout link when the report is instant pay and we hold the ground for it. Every other order waits for an analyst to confirm scope with the buyer. Nothing is charged until then.
A first order (a new agent operator or a new buyer) pays as usual. A person at ARUON checks it before the report is released.
Where an order offers payment in USDC on its order page, one payment is taken per order: once a USDC payment starts, the card checkout link is withdrawn. Unless the payment service has already verified the buyer's email, it mails a six-digit code to the human buyer's own inbox, never to the agent. The person must give that code to the agent; an agent cannot complete a USDC payment without it.
USDC on Base is open to every buyer: see Pay with crypto below.

Jobs we do

Each job is one report, ordered by its SKU (the MCP tool create_order, or POST https://reir.aruon.ai/api/hub/order). Prices in US dollars, from the catalog.

Red-flag screen on one address: ARUON Property Screen (screen_parcel), $649. Address or parcel ID in, analyst-released PDF out: owner of record where we hold the county, flood, wetlands, slope, soils, habitat, electric territory, transmission proximity, broadband. Traffic and daytime demand when the use needs them. NOI, cap rate, cash-on-cash and DSCR when you give an asking price. Sample: https://reir.aruon.ai/api/hub/sample/screen_parcel/view Order: https://reir.aruon.ai/#parcel Page: https://reir.aruon.ai/products/industrial-red-flag-screen-dallas-tx (markdown: https://reir.aruon.ai/products/industrial-red-flag-screen-dallas-tx.md)
Storage/industrial site search in a ZIP: ARUON Site Search (site_search), $1,900. Ranked candidate parcels inside a ZIP or county you name, for commercial, industrial, storage and retail ground. You set the search radius, the acreage floor and the constraints that matter; we screen every candidate against the public layers and hand back a ranked list with the instrument that measured each one. Sample: https://reir.aruon.ai/api/hub/sample/site_search/view Order: https://reir.aruon.ai/#find Page: https://reir.aruon.ai/products/storage-site-search-palmer-ma (markdown: https://reir.aruon.ai/products/storage-site-search-palmer-ma.md)
Cell-tower pad ranking with FCC ASR separation: ARUON Tower Sheet (tower_sheet), $1,250. Ranked candidate tower sites in a ring around your pin, each with its owner of record, assessed value, lot size and mapped district, screened for flood, wetlands, slope and habitat. Every FCC-registered structure in reach, with its owner, and every tower on the FAA's charted-obstacle file, which adds shorter ones the FCC file does not hold, is measured against each site under the jurisdiction's own separation rule where it writes one, and that siting rule is quoted with its section in an appendix. A labelled national ground-rent benchmark, and the open questions to settle with the permitting authority. Sample: https://reir.aruon.ai/api/hub/sample/tower_sheet/view Order: https://reir.aruon.ai/#wireless Page: https://reir.aruon.ai/products/cell-tower-site-ranking-orlando-fl (markdown: https://reir.aruon.ai/products/cell-tower-site-ranking-orlando-fl.md)
Edge/proximity-compute county ranking: PCS Market Scan (market_scan), $1,250. A ranked county report for a 1–20 MW edge or proximity-compute brief. Demand by industry, power cost and who serves each county, business fiber and exchange points in reach, interconnection queues and dated announcements re-fetched from the publisher. Sample: https://reir.aruon.ai/api/hub/sample/market_scan/view Order: https://reir.aruon.ai/pcs?product=market_scan Page: https://reir.aruon.ai/products/edge-data-center-county-ranking-texas (markdown: https://reir.aruon.ai/products/edge-data-center-county-ranking-texas.md)
Housing market screen on a ZIP: ARUON Housing Screen (market_report), $149. Rent, value, price index, inventory and demographics for the housing stock in one ZIP, benchmarked ZIP → metro → state → national, plus how three investor profiles — balanced, cash-flow and appreciation — read it differently. Sample: https://reir.aruon.ai/api/hub/sample/market_report/view Order: https://reir.aruon.ai/#market Page: https://reir.aruon.ai/products/housing-market-screen-zip-01007-ma (markdown: https://reir.aruon.ai/products/housing-market-screen-zip-01007-ma.md)

Pay with crypto

USDC on the Base network (mainnet) is the one cryptocurrency we accept: no other coin, token or network. One USDC counts as one US dollar. The buyer pays from the buyer's own wallet; no agent and no tool here moves money.

1. Place the order: the MCP tool create_order or POST https://reir.aruon.ai/api/hub/order. get_order_status carries a crypto block on an order that can be paid in USDC.
2. Start the payment: the MCP tool start_crypto_payment (or POST https://reir.aruon.ai/api/hub/crypto/start) with the order token, the billing address, the buyer's role, the wallet the buyer will send from, and the buyer's acceptance of the terms (accept, accept_terms). Once a USDC payment starts, the card checkout link is withdrawn: one payment per order.
3. The code: unless the payment service has already verified the buyer's email, it emails a six-digit code to the human buyer's own inbox, never to the agent. Ask the person for it; an agent cannot finish a USDC payment without it.
4. Get the quote: the MCP tool confirm_crypto_payment (or POST https://reir.aruon.ai/api/hub/crypto/confirm) with the code. The answer is the quote: the exact USDC amount, the address to send it to, and 20 minutes to send it.
5. Send exactly that amount, from the wallet named in step 2, on Base. The payment counts once it is final, usually 20 to 30 minutes after it is sent (Base finality, then two independent providers must agree); get_order_status says where it stands.
6. Quote expired: the MCP tool request_new_quote (or POST https://reir.aruon.ai/api/hub/crypto/quote) gives a fresh 20-minute quote at a new exact amount.

Limits while crypto opens: at most 3 crypto orders a day across all buyers (the day resets at midnight UTC), and 1 unpaid crypto order per buyer email. Past either, the card link still works and nothing is charged.
Refunds go only to the wallet that paid, in USDC on Base, made by hand by a person at ARUON. See the refund policy.
Every order is screened before a quote and again when its payment arrives. A screened order can be held for a person at ARUON; a payment that arrives on a held order is recorded, and if ARUON does not go ahead the full amount goes back by hand to the wallet that paid.
Paying does not release a report: a person at ARUON releases every report.

USDC amounts per report before tax (exact amount with a unique tag is given at checkout). Texas sales tax applies.:

market_report: 149.00 USDC
market_scan: 1250.00 USDC
scout_shortlist_founding: 3000.00 USDC
screen_parcel: 649.00 USDC
site_search: 1900.00 USDC
tower_sheet: 1250.00 USDC

1. The catalog and prices

GET https://reir.aruon.ai/pricing.json (the same file at https://reir.aruon.ai/.well-known/pricing.json): every report with sku, name, price_usd (null where the report is quoted), purchasable, instant_pay, requires_scope_review, turnaround, deliverable_summary, sample_url, order_url, terms_url, credit_rules, updated_at and catalog_version.

GET https://reir.aruon.ai/api/hub/catalog is the order page's own feed of the same catalog. While ordering is closed it answers ok: false with a reason and no products.

2. Check coverage

GET https://reir.aruon.ai/api/coverage/band?sku=<sku> plus ONE place: state and county_fips, or lat and lng, or zip, or address. It always answers HTTP 200; ok: false is a refusal with its reason. An address is up to 100 characters, and address lookups are limited to 30 per hour per connection.

Field	Meaning
`band`	`full_data` (we hold the parcel record), `zip_only` (market data at ZIP grain), or `unknown`.
`source_id`	The parcel source that holds the county, or null.
`source_label`	That source's name, or null.
`zoning_screened`	Whether zoning is screened in this county.
`sla_hours`	24 where this report runs on the 24-hour clock here; otherwise null.
`ok`	false is a refusal: read `reason`.
`reason`	Why, in a sentence.
`area_scan`	For the ring searches: the ordered ring is loaded (a source is registered and the ring is on disk).
`area_source`	A bulk source is registered for the county.
`area_loaded`	The ring asked about is loaded.
`ring`	The ring the reading was asked about.
`sku`	The report the reading is for.
`state`	Two-letter state.
`county_fips`	Five-digit county FIPS.
`county_resolution`	How a ZIP, an address or a point became a county.
`county_name`	The county's name.
`opt_in_ring`	The ring is the opt-in large ring (always quoted).
`document_hold`	Why the Property Screen is quoted in this county, when it is.
`version`	The record's version.

A band other than full_data, or ok: false, means an analyst confirms scope before anything is charged.

3. Place an order

POST https://reir.aruon.ai/api/hub/order with a JSON body (Content-Type: application/json, up to 64 KiB). The fields:

Field	Type	Required	Meaning
`sku`	string	yes	The report, by its catalog key (list_products / pricing.json). (one of: `market_scan`, `scout_shortlist_founding`, `screen_parcel`, `market_report`, `tower_sheet`, `tower_targets`, `site_search`)
`full_name`	string	yes	The buyer's name.
`email`	string	yes	The buyer's email. The one confirmation and the report go here; it must be a deliverable address.
`company`	string	no	The buyer's company (optional).
`phone`	string	no	The buyer's phone (optional).
`consent`	boolean	yes	true: the buyer accepts the Privacy Policy and the SMS terms. Required.
`paid_ack`	boolean	yes	true: the buyer acknowledges, verbatim: “I understand this is a paid engagement. After payment, an ARUON analyst checks the order and starts the report; the clock starts at our analyst's go-ahead, not at the card charge.” Required.
`geography`	object	yes	ONE place. kind=address: {address}; kind=zip: {zip}; kind=county: {state, county_fips}; kind=parcel: {state, county_fips, parcel_id}; kind=pin: {lat, lng} (saved as coordinates, never turned into an address).
`use`	string	no	Intended use, for the SKUs that read one (Property Screen, Tower Sheet, Site Search). (one of: `data_center`, `edge_data_center`, `cell_tower`, `storage_units`, `condo_development`, `multi_family`, `commercial_property`, `strip_mall_retail`, `mixed_use_development`, `industrial_warehouse`, `single_family`, `other`)
`notes`	string	no	Anything the analyst should read; longer text is cut at 4,000 characters. Read by a person; it changes nothing automatically.
`asking_price`	number	no	The asking price, where the report reads one (Property Screen, Housing Screen).
`must`	array	no	Must-have chips for the ring searches (Tower Sheet, Site Search): the catalog's hunt_chips keys; min_acres posts as min_acres=<n>.
`nice`	array	no	Nice-to-have chips, same keys. Emphasis only; they filter nothing.
`radius_mi`	integer	no	Search radius in whole miles, 1–100, for the ring searches. Blank is the default ring.
`site_acres`	number	no	Site size the buyer needs, in acres (read by the analyst).
`min_acres`	number	no	Minimum lot size in acres; it filters the search only when posted as a must-have.
`ai_agent_name`	string	no	The agent placing the order. (up to 120 characters)
`agent_operator`	string	no	The organisation that runs the agent. A person checks the first order from an operator before its report is released. (up to 120 characters)
`on_behalf_of`	string or object	no	The principal the agent orders for: a name, or {name, organization, email}.

Send only these fields. website is reserved: it is the order form's bot trap, and an order that carries it is dropped without notice. The server reads the price, the coverage band and the payment mode itself; a posted price or band is ignored.

Search radius: whole miles, 1–100. A geography the server cannot place, a ZIP that does not exist, a missing field or an invalid email is refused with HTTP 400 before anything is written.

{
  "sku": "market_report",
  "full_name": "Pat Buyer",
  "email": "pat@example.com",
  "consent": true,
  "paid_ack": true,
  "geography": {
    "kind": "zip",
    "zip": "01027"
  },
  "ai_agent_name": "Example buying agent",
  "agent_operator": "Example Agents Inc",
  "on_behalf_of": {
    "name": "Pat Buyer",
    "organization": "Buyer Co"
  }
}

HTTP 202 means the order is filed:

Field	Meaning
`ok`	true
`token`	The order token: the order's secret. Keep it; the status and the order page read it.
`mode`	`pay` (instant pay, a checkout link) or `scope` (an analyst confirms scope first).
`pay_url`	The HubSpot checkout link, only when `mode` is `pay`; otherwise null.
`band`	The coverage band the server read for this order (see the coverage check).
`sla_hours`	24 where the order runs on the 24-hour clock (The clock starts at our analyst's go-ahead, not at the card charge.); otherwise null.
`status`	The order record's status (`awaiting_payment` or `awaiting_approval`).
`agent_status`	The same status in the words below (Status words).
`request_id`	The order number.
`sku`	The report ordered.
`label`	The report's name.
`price_line`	The price as the catalog prints it, or null where the report is quoted.
`order_url`	The order page, `/order/<token>`. A bearer link: anyone who has it can read the order and pay for it, so keep it private.
`note`	Why the order is on the scope path, or how it was placed, when there is something to say; otherwise null.

Refusals: HTTP 400 {ok: false, reason, errors}; HTTP 413 when the body is too large; HTTP 429 {ok: false, reason} past a rate limit; HTTP 500 {ok: false, status: "error", message, reason, correlation_id} when the fault is ours. Quote the correlation_id if you write to us.

4. Read an order's status

GET https://reir.aruon.ai/api/hub/order/<token> answers the order's record; an unknown token is HTTP 404 {ok: false, error: "not found"}. The order page /order/<token> shows the same record. The token is the order's secret; the buyer's email is masked. The order link in the buyer's order email is a bearer link: anyone who has it can read the order and pay for it, so keep it private.

Field	Meaning
`ok`	true
`token`	The order token.
`request_id`	The order number.
`status`	The order record's status.
`agent_status`	The same status in the words below (Status words).
`mode`	`pay` or `scope`, as the order was taken.
`sku`	The report ordered.
`label`	The report's name.
`band`	The coverage band read when the order was taken.
`sla_hours`	24 or null, as above.
`email_masked`	The buyer's email, masked (`ab…@example.com`).
`pay_url`	The checkout link while the order awaits payment; otherwise null.
`created_at`	When the order was taken (ISO 8601, UTC).
`paid_at`	When HubSpot recorded the payment, or null.
`go_at`	When an analyst gave the go-ahead (the clock's start), or null.
`payment_note`	Present only once a USDC payment has started on an order awaiting payment: why `pay_url` is null. One payment per order: the card link is withdrawn.
`payment_state`	Present with `payment_note`: where the USDC payment stands, `{state, status, head, line, why, next, words}`. `status` is the status word (`held` while a person at ARUON reviews it); `line` is the status in a phrase, `why` the reasons in plain words (or null), `next` what happens next, and `words` all three. The MCP tools' `meaning` is `words`.

5. Status words

agent_status (and the MCP tools' status) is one of:

Status	Meaning
`awaiting_payment`	Instant pay: finish checkout at checkout_url. Nothing runs before payment. Work begins at our analyst's go-ahead.
`awaiting_scope_review`	An analyst confirms scope with the buyer first, then sends the payment link or an invoice. Nothing is charged until then.
`awaiting_human_approval`	An order filed before 2026-11-04 from an agent operator we had not approved yet: a person approves it before any checkout link. Nothing is charged until then.
`paid`	Paid. The clock starts at our analyst's go-ahead, not at the card charge.
`in_production`	The report is being built.
`in_review`	The report is built and an analyst is reading it before release.
`delivered`	Released by an analyst and sent to the buyer's email.
`held`	A person at ARUON is looking at the order. Nothing is charged or sent until they act.
`received`	Received.
`closed`	Closed. No report will be sent on this order.

6. The MCP server

https://reir.aruon.ai/mcp speaks the Model Context Protocol over streamable HTTP: one JSON-RPC message per POST, answered as JSON (a notification gets HTTP 202 and no body). It offers tools only, keeps no session and opens no stream: GET and DELETE answer 405. Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26. A request may carry no Origin header or this site's own; any other is refused (HTTP 403).

It is listed in the official MCP Registry as io.github.Aruon-AI/reir: https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Aruon-AI%2Freir. No sign-in: add https://reir.aruon.ai/mcp as a remote MCP server (streamable HTTP) in any client that takes one.

Tool	What it does	Read-only
`list_products`	List products and prices	yes
`check_coverage`	Check coverage for a place	yes
`create_order`	Place an order (nothing is charged here)	no — files an order
`get_order_status`	Get an order's status	yes
`start_crypto_payment`	Pay an order by crypto instead of the card link	no — files an order
`confirm_crypto_payment`	Confirm the buyer's code and get the crypto quote	no — files an order
`request_new_quote`	Get a new crypto quote after the last one expired	no — files an order

Every tool calls the same code as the HTTP endpoints above: list_products returns the pricing.json records, check_coverage the coverage record, create_order files the order through the order door and returns {order_token, status, checkout_url} (checkout_url only for awaiting_payment), and get_order_status reads the status record. create_order requires ai_agent_name and agent_operator. No tool charges, starts or releases anything.

list_products — input

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

check_coverage — input

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "sku"
  ],
  "description": "ONE place: state + county_fips, lat + lng, zip, or address.",
  "properties": {
    "sku": {
      "type": "string",
      "enum": [
        "market_scan",
        "scout_shortlist_founding",
        "screen_parcel",
        "market_report",
        "tower_sheet",
        "tower_targets",
        "site_search"
      ],
      "description": "The report the coverage is read for."
    },
    "state": {
      "type": "string",
      "description": "Two-letter state (with county_fips)."
    },
    "county_fips": {
      "type": "string",
      "description": "Five-digit county FIPS."
    },
    "place_fips": {
      "type": "string",
      "description": "Optional place FIPS."
    },
    "lat": {
      "type": "number"
    },
    "lng": {
      "type": "number"
    },
    "zip": {
      "type": "string",
      "description": "A five-digit ZIP (its primary county)."
    },
    "address": {
      "type": "string",
      "description": "A street address (geocoded once; address lookups are limited per connection)."
    }
  }
}

create_order — input

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "enum": [
        "market_scan",
        "scout_shortlist_founding",
        "screen_parcel",
        "market_report",
        "tower_sheet",
        "tower_targets",
        "site_search"
      ],
      "description": "The report, by its catalog key (list_products / pricing.json)."
    },
    "full_name": {
      "type": "string",
      "description": "The buyer's name."
    },
    "email": {
      "type": "string",
      "description": "The buyer's email. The one confirmation and the report go here; it must be a deliverable address."
    },
    "company": {
      "type": "string",
      "description": "The buyer's company (optional)."
    },
    "phone": {
      "type": "string",
      "description": "The buyer's phone (optional)."
    },
    "consent": {
      "type": "boolean",
      "description": "true: the buyer accepts the Privacy Policy and the SMS terms. Required."
    },
    "paid_ack": {
      "type": "boolean",
      "description": "true: the buyer acknowledges, verbatim: “I understand this is a paid engagement. After payment, an ARUON analyst checks the order and starts the report; the clock starts at our analyst's go-ahead, not at the card charge.” Required."
    },
    "geography": {
      "type": "object",
      "description": "ONE place. kind=address: {address}; kind=zip: {zip}; kind=county: {state, county_fips}; kind=parcel: {state, county_fips, parcel_id}; kind=pin: {lat, lng} (saved as coordinates, never turned into an address).",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "zip",
            "county",
            "parcel",
            "pin",
            "address"
          ]
        },
        "address": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "county_fips": {
          "type": "string"
        },
        "parcel_id": {
          "type": "string"
        },
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        }
      },
      "required": [
        "kind"
      ]
    },
    "use": {
      "type": "string",
      "enum": [
        "data_center",
        "edge_data_center",
        "cell_tower",
        "storage_units",
        "condo_development",
        "multi_family",
        "commercial_property",
        "strip_mall_retail",
        "mixed_use_development",
        "industrial_warehouse",
        "single_family",
        "other"
      ],
      "description": "Intended use, for the SKUs that read one (Property Screen, Tower Sheet, Site Search)."
    },
    "notes": {
      "type": "string",
      "description": "Anything the analyst should read; longer text is cut at 4,000 characters. Read by a person; it changes nothing automatically."
    },
    "asking_price": {
      "type": "number",
      "description": "The asking price, where the report reads one (Property Screen, Housing Screen)."
    },
    "must": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Must-have chips for the ring searches (Tower Sheet, Site Search): the catalog's hunt_chips keys; min_acres posts as min_acres=<n>."
    },
    "nice": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Nice-to-have chips, same keys. Emphasis only; they filter nothing."
    },
    "radius_mi": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Search radius in whole miles, 1–100, for the ring searches. Blank is the default ring."
    },
    "site_acres": {
      "type": "number",
      "minimum": 0,
      "description": "Site size the buyer needs, in acres (read by the analyst)."
    },
    "min_acres": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum lot size in acres; it filters the search only when posted as a must-have."
    },
    "ai_agent_name": {
      "type": "string",
      "maxLength": 120,
      "description": "The agent placing the order."
    },
    "agent_operator": {
      "type": "string",
      "maxLength": 120,
      "description": "The organisation that runs the agent. A person checks the first order from an operator before its report is released."
    },
    "on_behalf_of": {
      "description": "The principal the agent orders for: a name, or {name, organization, email}.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "name": {
              "type": "string"
            },
            "organization": {
              "type": "string"
            },
            "email": {
              "type": "string"
            }
          }
        }
      ]
    }
  },
  "required": [
    "sku",
    "full_name",
    "email",
    "consent",
    "paid_ack",
    "geography",
    "ai_agent_name",
    "agent_operator"
  ],
  "additionalProperties": false
}

get_order_status — input

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "order_token"
  ],
  "properties": {
    "order_token": {
      "type": "string",
      "description": "From create_order."
    }
  }
}

start_crypto_payment — input

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "order_token",
    "rail",
    "billing",
    "role",
    "wallet_address",
    "accept",
    "accept_terms"
  ],
  "properties": {
    "order_token": {
      "type": "string"
    },
    "rail": {
      "type": "string"
    },
    "billing": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "line1",
        "city",
        "postal",
        "country"
      ],
      "properties": {
        "line1": {
          "type": "string"
        },
        "line2": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "postal": {
          "type": "string"
        },
        "country": {
          "type": "string"
        }
      }
    },
    "role": {
      "type": "string",
      "enum": [
        "investor",
        "broker",
        "carrier",
        "developer",
        "other"
      ]
    },
    "wallet_address": {
      "type": "string"
    },
    "phone": {
      "type": "string",
      "description": "The buyer's phone. Required here when the order was placed without one."
    },
    "accept": {
      "type": "boolean",
      "description": "The buyer accepts the terms, the refund policy and the privacy policy for this payment, and this acknowledgment (hub-ack-2026-11-02-crypto): \"I understand this is a paid engagement. After payment, an ARUON analyst checks the order and starts the report; the clock starts at our analyst's go-ahead, not at payment (the card charge or the USDC payment).\""
    },
    "accept_terms": {
      "type": "boolean",
      "description": "Must be true: the buyer has read and accepts Schedule C (Crypto Payments) of ARUON's Terms of Service, version 2026-11-06.1: https://aruon.ai/terms-of-service#schedule-c. Required before the code is emailed and before any payment; a call without it is refused and nothing is filed."
    }
  }
}

confirm_crypto_payment — input

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "order_token",
    "code"
  ],
  "properties": {
    "order_token": {
      "type": "string"
    },
    "code": {
      "type": "string"
    }
  }
}

request_new_quote — input

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "order_token"
  ],
  "properties": {
    "order_token": {
      "type": "string"
    }
  }
}

7. Agent fields

ai_agent_name: the agent placing the order (up to 120 characters).
agent_operator: the organisation that runs the agent (up to 120 characters). Required whenever any agent field is sent, and on the MCP server. A person at ARUON checks the first order from an operator before its report is released; payment is not held for it.
on_behalf_of: the buyer the agent orders for — a name, or an object with name, organization and email (a valid address).
Text only, no control characters. The fields are stored with the order and on the order's record in our CRM. They are the agent's own statement: we do not verify them.

8. Limits

Limit	Value
Orders per connection (IP address)	5 per hour
Orders per agent operator	5 per hour
MCP requests per connection	300 per hour
Address lookups on the coverage check	30 per hour per connection
Request body (orders, MCP)	64 KiB
Email	a deliverable mailbox address of up to 254 characters