AstraNL

Turn a real-world task or question into a routing decision: whether AstraNL can help, which one tool to call, what to supply, what can and cannot be verified. No commitment, nothing created, no key. Also answers whether a physical task is feasible in the Netherlands.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "maxLength": 400,
      "description": "your task or question in plain words, any language"
    }
  },
  "required": [
    "question"
  ],
  "additionalProperties": false
}

Check a Dutch or EU counterparty against official sources before your own next step, such as onboarding a supplier, paying an invoice or signing an order. Give the KvK number, the company name and the EU VAT number as your document states them. Returns verdicts, not register data: whether the KvK number has an active registration, whether the name matches a registered name, whether the VAT number is valid in VIES and whether its VIES name matches the register, EU sanctions list candidates, whether an insolvency case is published under the KvK number in the Dutch insolvency register, open questions and a check_id. Read-only, no key, no cost. AstraNL does not search the Dutch register by name; look a number up at kvk.nl. When a colleague or auditor must verify it later, call record_counterparty_check with the check_id. It does not prove who may sign for the company, who owns a bank account, solvency or reliability.

{
  "type": "object",
  "properties": {
    "kvk_number": {
      "type": "string",
      "maxLength": 12,
      "description": "Dutch KvK number, 8 digits, as printed on the invoice, quote or website"
    },
    "company_name": {
      "type": "string",
      "maxLength": 200,
      "description": "the company name exactly as your document or contact states it"
    },
    "vat_number": {
      "type": "string",
      "maxLength": 20,
      "description": "EU VAT number with country prefix, for example NL810433941B01"
    },
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "not used; kept for compatibility, AstraNL does not search the register by name"
    },
    "purpose": {
      "type": "string",
      "maxLength": 200,
      "description": "optional: the next action you are about to take, for example approve supplier or pay invoice"
    }
  },
  "minProperties": 1,
  "additionalProperties": false
}

Make a result of check_counterparty_nl verifiable by others: records its digest in the AstraNL signed public log and returns a reference that a colleague, approver or auditor can check later with verify_astranl, without trusting AstraNL. Works only for a check AstraNL produced in the last 48 hours. The public record holds no name, number or address of the checked party. Calling it again returns the same reference.

{
  "type": "object",
  "properties": {
    "check_id": {
      "type": "string",
      "maxLength": 40,
      "description": "the check_id returned by check_counterparty_nl, ASTRA-K- and 16 characters"
    }
  },
  "required": [
    "check_id"
  ],
  "additionalProperties": false
}

Ask AstraNL to find and coordinate a verified executor for a physical task in the Netherlands. Returns an ingress receipt at once and a case once planning found a path; the client pays the executor directly; AstraNL holds no money. Fee: submitting costs nothing; AstraNL charges 1 percent of the transaction only when it coordinated a completed paid task, nothing else.

{
  "type": "object",
  "properties": {
    "need": {
      "type": "string",
      "maxLength": 800,
      "description": "what must happen, in plain words"
    },
    "location": {
      "type": "string",
      "maxLength": 200,
      "description": "city or address in the Netherlands"
    },
    "deadline": {
      "type": "string",
      "maxLength": 100,
      "description": "by when; ISO date or plain words"
    },
    "proof": {
      "type": "string",
      "maxLength": 400,
      "description": "what evidence closes the task, agreed before work starts"
    },
    "budget_cents": {
      "type": "integer",
      "minimum": 100,
      "description": "budget in euro cents"
    },
    "reply_channel": {
      "type": "string",
      "maxLength": 300,
      "description": "email or https URL where AstraNL may answer you"
    },
    "synthetic": {
      "type": "boolean",
      "description": "true marks a test that must never be counted or executed"
    }
  },
  "required": [
    "need"
  ],
  "additionalProperties": false
}

Current state of a task or ingress receipt from create_task, and who must act next. Returns only what is recorded; infers nothing.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "maxLength": 40,
      "description": "task id from check_task or a case"
    },
    "receipt_id": {
      "type": "string",
      "maxLength": 40,
      "description": "RCPT-n from create_task"
    },
    "receipt_key": {
      "type": "string",
      "maxLength": 80,
      "description": "owner key shown once by create_task; without it links are read-only"
    }
  },
  "minProperties": 1,
  "additionalProperties": false
}

Machine-checkable evidence for an AstraNL task, action or receipt: the signed log events that mention it, each verified live, with a proof block stating what is verified, what is not, validity, status, limitations and next actions.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "maxLength": 40,
      "description": "task id, action id or receipt id"
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false
}

Verify any AstraNL reference without a key. Returns two separate layers: integrity (payload hash, Ed25519 signature, Merkle inclusion, recomputed live) and claim (what exactly is attested, by whom, from which source, when, under which method, with which validity limits and current status VALID/EXPIRED/REVOKED/UNKNOWN). Integrity never implies the claim is true for your purpose; you apply your own acceptance rules. Tells you when to re-verify and how to consume a VALID receipt for a next action. Read-only, deterministic, no model in the path.

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 4,
      "maxLength": 64,
      "description": "Any AstraNL reference: action receipt ASTRA-A-..., policy receipt ASTRA-R-..., consumption ASTRA-C-..., log event alk_..., attestation att_/atr_..., ingress receipt RCPT-n"
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

Get compact, source-linked real-world context for an LLM in ONE read-only call. Searches AstraNL public materials or tender records, or its protocol identity. Use source=public_tenders for tenders, materials for products; auto keeps domains separate. Returns record update times, fresh/stale/unknown labels, record disagreements, coverage gaps and ready-to-use context_text. Never books, contacts or pays anyone. Not a general web search: no match is not proof of absence; a cached price is not a quote. Optional astranl.reality-link.v2 profile checks exact source-record claims. It does not promote registry records to independently verified real-world facts. official.deadline on tender:TED-* records is checked live at the EU publisher (TED), budgeted and cached; unavailable means UNKNOWN.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 1600,
      "description": "Short subject, product keywords or identifier; all product keyword groups must match."
    },
    "source": {
      "type": "string",
      "enum": [
        "auto",
        "materials",
        "public_tenders",
        "protocol_identity",
        "all"
      ],
      "default": "auto",
      "description": "v1: auto, materials, public_tenders, protocol_identity or all. v2 requires an explicit materials, public_tenders or protocol_identity."
    },
    "max_items": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "default": 6,
      "description": "v1 only; v2 looks up at most 12 records and refuses max_items."
    },
    "budget_ms": {
      "type": "integer",
      "minimum": 50,
      "maximum": 1500,
      "default": 750
    },
    "max_age_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 604800,
      "default": 86400
    },
    "protocol": {
      "type": "string",
      "enum": [
        "astranl.reality-link.v2"
      ],
      "description": "Omit for the v1 context call. Set to astranl.reality-link.v2 together with claims to check typed claims against source records."
    },
    "claims": {
      "type": "array",
      "minItems": 1,
      "maxItems": 16,
      "description": "v2 only. Each claim names a record id from a previous result, a predicate and the expected value.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "record_id",
          "predicate",
          "expected"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "record_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "predicate": {
            "type": "string",
            "enum": [
              "record.title",
              "record.brand",
              "record.listed_price",
              "record.stock_reported",
              "record.closing_date",
              "reality.stock_available",
              "reality.delivery_by",
              "reality.suitable_for",
              "official.deadline"
            ]
          },
          "expected": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 600
              },
              {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "amount",
                  "currency"
                ],
                "properties": {
                  "amount": {
                    "type": "string",
                    "pattern": "^\\d{1,10}(\\.\\d{1,2})?$"
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Z]{3}$"
                  }
                }
              }
            ]
          }
        }
      }
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Ground a machine, robot or industrial automation component in live market reality with ONE call. Give a manufacturer part number and optionally the maker. AstraNL queries its verified distributor connections (Nexar/Octopart, Mouser, element14/Farnell NL, OEMsecrets) in parallel, keeps only offers whose part number matches exactly after normalisation, screens maker and sellers against the EU consolidated sanctions list and the US Consolidated Screening List, and returns availability, stock seen, authorized sellers, lowest unit price seen in EUR, lifecycle values and per-source status. When AstraNL holds the manufacturer own lifecycle or discontinuation page for the part, the answer also carries manufacturer_lifecycle: status, date, the successor the manufacturer names and the page SHA-256, kept separate from seller-reported values; asking for a successor also shows which discontinued part it replaces. Every fresh answer carries a SHA-256 digest sealed with the AstraNL moment seal and an AstraLock event id you can check later with verify_astranl. Limits: distributor data is seller-reported at the observed time, not a quote and not a delivery promise; NOT_FOUND_IN_CHECKED_SOURCES means only these sources; answers are cached for 24 hours. Never orders, contacts or pays anyone. Writes (why the tool is not read-only): each fresh answer, not one served from the 24 hour cache, appends one event to the public AstraLock log with the part number, the maker, the digest, the availability and the number of exact offers, so the answer can be verified later, and stores the answer in an AstraNL database table (component_groundings) that serves the cache and counts the budget; the row names only the door (mcp), nothing about the caller. Live budget: 40 fresh reads a day across all MCP callers; after that only cached answers, status DAILY_LIVE_BUDGET_SPENT. Logging: every MCP call is journaled with the tool name, outcome, argument length, caller class (external, probe, crawler, self), a SHA-256 hash of the caller network /24 and the client family; for demand statistics also the first 160 characters of a query, question, title or id argument and the user-agent; never the address itself, other arguments or an account.

{
  "type": "object",
  "properties": {
    "mpn": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "description": "manufacturer part number, exactly as printed by the maker, e.g. 1756-L85E"
    },
    "manufacturer": {
      "type": "string",
      "maxLength": 80,
      "description": "optional maker name, e.g. Allen-Bradley; offers from other makers are then dropped"
    }
  },
  "required": [
    "mpn"
  ],
  "additionalProperties": false
}

Check one scientific reference before you reuse or cite it, with ONE call. Give a DOI. AstraNL reads the Crossref work record and every Crossref notice that updates it, the OpenAlex retraction flag and the Europe PMC publication types and retraction, erratum and concern links, and returns a status: RETRACTION_NOTICE_FOUND, EXPRESSION_OF_CONCERN_FOUND, CORRECTION_NOTICE_FOUND, NO_NOTICE_IN_CHECKED_SOURCES or NOT_FOUND_IN_CHECKED_SOURCES, with each notice DOI, type and date, the source URLs and the observation time. Every fresh answer carries a SHA-256 digest sealed with the AstraNL moment seal and an AstraLock event id you can check later with verify_astranl. Limits: registry data at the observed time, never a judgement of the science; NO_NOTICE_IN_CHECKED_SOURCES means only these three registries; answers are cached for 24 hours. Never contacts authors or publishers. Writes (why the tool is not read-only): each fresh answer, not one served from the 24 hour cache, appends one event to the public AstraLock log with the DOI, the digest and the status, so the answer can be verified later, and stores the answer in an AstraNL database table (citation_groundings) that serves the cache and counts the budget; the row names only the door (mcp), nothing about the caller. Live budget: 300 fresh reads a day across all MCP callers; after that only cached answers, status DAILY_LIVE_BUDGET_SPENT. Logging: every MCP call is journaled with the tool name, outcome, argument length, caller class (external, probe, crawler, self), a SHA-256 hash of the caller network /24 and the client family; for demand statistics also the first 160 characters of a query, question, title or id argument and the user-agent; never the address itself, other arguments or an account.

{
  "type": "object",
  "properties": {
    "doi": {
      "type": "string",
      "minLength": 7,
      "maxLength": 300,
      "description": "the DOI of the work, bare or as a doi.org link, e.g. 10.1038/s41593-021-00895-5"
    }
  },
  "required": [
    "doi"
  ],
  "additionalProperties": false
}

One-call overview of Dutch construction facts: permit publications last 90 days (national), lead-time status, number of open public works tenders, latest CBS periods, construction laws taking effect in the next 365 days. Permit kind accuracy is measured, not assumed: manual validation gate B on a 200-row sample (2026-10-05) gave precision 0.98, Wilson 95% lower bound 0.94, 11% unclassified; the current figures come back in accuracy, and the unknown bucket (OVERIG, BESLUIT_ONBEKEND) is shown separately. Permit aggregates only: no permit rows, publication identifiers, titles, addresses, points or names; permit counts below 5 per authority per kind are shown as <5 and totals that would reveal one are lower bounds (>=n). Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

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

Official permit publications counted per issuing body (municipality, province, water board) and kind (application, granted, refused, ...) over the last N days (default 90, max 400). Permit kind accuracy is measured, not assumed: manual validation gate B on a 200-row sample (2026-10-05) gave precision 0.98, Wilson 95% lower bound 0.94, 11% unclassified; the current figures come back in accuracy, and the unknown bucket (OVERIG, BESLUIT_ONBEKEND) is shown separately. Permit aggregates only: no permit rows, publication identifiers, titles, addresses, points or names; permit counts below 5 per authority per kind are shown as <5 and totals that would reveal one are lower bounds (>=n). Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "gemeente": {
      "type": "string",
      "maxLength": 80,
      "description": "municipality / issuing body as published, e.g. Utrecht"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "description": "window in days, default 90"
    },
    "max_municipalities": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "cap the municipality list for context size, default 40"
    }
  },
  "additionalProperties": false
}

Permit lead times (application to decision, median and quartiles) from official pairs. Currently CLOSED: the answer says CLOSED with the reason until validation gate C passes; no lead time is estimated before that. Permit aggregates only: no permit rows, publication identifiers, titles, addresses, points or names; permit counts below 5 per authority per kind are shown as <5 and totals that would reveal one are lower bounds (>=n). Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "gemeente": {
      "type": "string",
      "maxLength": 80,
      "description": "municipality / issuing body as published, e.g. Utrecht"
    }
  },
  "additionalProperties": false
}

Open Dutch public works tenders from TenderNed (announcements with a future closing date): buyer, CPV, procedure, published and closing date, days left, European flag, TenderNed id and link. Tender names are not returned; open the link for the full notice. Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

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

Construction law calendar: dated rules in force or planned (Omgevingswet, Wkb, EPBD IV, MPG, CPR, ...), each with its own official or sector source and last-verified date; rows whose planned date passed are flagged needs_reverify. Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "upcoming_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650,
      "description": "only rules taking effect within this many days"
    }
  },
  "additionalProperties": false
}

CBS construction economy: build cost input price index, construction bankruptcies, construction vacancy rate (latest stored period, CBS status Voorlopig/Definitief per row, freshness) plus CBS indicators (dwelling permits, establishments, labour). Provisional figures are revised by CBS. Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

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

Dutch zero-emission and low-emission zones from NDW as published: municipality, zone label, status, start, vehicle categories, transition rules, bbox centre; derived_ze_logistics is derived by AstraNL. Source recount (ids and hashes) is reported. Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "gemeente": {
      "type": "string",
      "maxLength": 80,
      "description": "municipality / issuing body as published, e.g. Utrecht"
    }
  },
  "additionalProperties": false
}

Natura 2000 sites in the Netherlands from RVO / PDOK: number, site label, protection type, status, site code, bounding box (lon/lat). Filter with site. Source recount is reported. Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "maxLength": 80,
      "description": "case-insensitive filter on the site label"
    }
  },
  "additionalProperties": false
}

CloudEvents 1.0 feed of construction signals, oldest first after since_id: daily permit aggregate cells (with gate B accuracy), newly published works tenders (AAO), laws coming up. Continue with next_since_id. Permit aggregates only: no permit rows, publication identifiers, titles, addresses, points or names; permit counts below 5 per authority per kind are shown as <5 and totals that would reveal one are lower bounds (>=n). Read-only. Every answer carries source provenance (source, source_url, licence, as_of, retrieved_at = when AstraNL last read the source, served_at, method, status) and an exposure block.

{
  "type": "object",
  "properties": {
    "since_id": {
      "type": "string",
      "maxLength": 40,
      "description": "sequence number or event id cs-... to continue after"
    },
    "type": {
      "type": "string",
      "enum": [
        "nl.astranl.construction.permits.daily",
        "nl.astranl.construction.tender.published",
        "nl.astranl.construction.law.upcoming"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "events per page, default 25"
    }
  },
  "additionalProperties": false
}

Dutch municipal rules for a renovation or building job, with ONE read-only call. Give a municipality, optionally the planned bouwkosten excluding VAT. Returns the 2026 omgevingsvergunning fee, leges, for the technical building activity as the municipality's own regulation sets it, and whether a skip or container on the public road needs a permit, a notification or nothing, with the permit fee and precario where confirmed. Every answer names the regulation, article and source URL, the read date and how it was verified. Coverage: all 342 municipalities for leges, 296 for containers. Limits: the municipality decides; spatial or other permit parts are not added; a fee is withheld when the tariff is not verified. Free, no auth, no side effects.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Dutch municipality name or CBS code, e.g. Zaanstad or GM0479"
    },
    "bouwkosten_eur": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "planned construction cost excluding VAT in euro; default 50000"
    }
  },
  "required": [
    "municipality"
  ],
  "additionalProperties": false
}

Check one building material in live Dutch store reality with ONE read-only call. Exact identity only: a GTIN with valid check digit, a store variant or the exact partner feed link; plain words return candidates you can check exactly next. Returns every offer of the same trade item with price incl. VAT, stock and read time per store (Bouwmaat, Hubo, Houtdirect through UCP search; partner shop feeds), the identical GTIN at other stores (verdict DIRECT_SUBSTITUTE, the only substitute named), the cheapest available offer, per source status and a sha256 digest. Limits: seller prices at read time, not a quote or delivery promise; delivery costs not included; NOT_FOUND covers only the sources listed. Never orders, pays or contacts anyone.

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "a GTIN or EAN with valid check digit (e.g. 8710839100056), a Bouwmaat, Hubo or Houtdirect product link with ?variant=, a partner shop product link, store:variant (e.g. hubo:48564194312444), or plain words for candidates"
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

Check every material line of an AstraNL estimate case you hold the token of (from estimate_case_create) against the current offer of the same product: PRICE_UP or PRICE_DOWN beyond 5 percent, UNAVAILABLE, NOT_FOUND_IN_CHECKED_SOURCES, CHEAPER_SAME_GTIN at another store, each with source and read time, plus the open findings of the daily monitor for that case. Read-only; an estimate is re-read live at most once in 6 hours.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]+$"
    }
  },
  "required": [
    "case_id",
    "token"
  ],
  "additionalProperties": false
}

Turn an AstraNL estimate into draft purchase lists for a project, one list per store and wave, and hand them to the project administrator. Needs the project agent key (agk_...) as X-Agent-Key on the connection; the estimate tools use the connection key, so use a separate connection. Read-only actions: me, case, estimate_links, list, order_status (reads an existing order record, it never places one). Actions that write: import_estimate (creates draft lists) and finish_list (sends one draft for approval). Required fields by action: me: none; case: project_id; import_estimate: project_id, estimate_case_id, estimate_token, idempotency_key; estimate_links: project_id; list: project_id, list_id; finish_list: project_id, list_id, list_revision, version, idempotency_key; order_status: project_id, order_id. Typical order: import_estimate, then list for each list_id, then finish_list with the revision and version read. The estimate must be RELEASED after review and must carry a material order plan, otherwise import_estimate answers a failure and writes nothing. If a write answers outcome_unknown, repeat the same call with the SAME idempotency_key; never use a new key. A project administrator approves the exact list. Nothing is ordered, approved or paid by this tool. A 202 means accepted for work, not completed.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "me",
        "case",
        "import_estimate",
        "estimate_links",
        "list",
        "finish_list",
        "order_status"
      ],
      "description": "what to do; see the tool description for the fields each action takes"
    },
    "project_id": {
      "type": "string",
      "pattern": "^PRJ-[A-Z0-9-]{1,80}$",
      "description": "the project case id, PRJ-..."
    },
    "estimate_case_id": {
      "type": "string",
      "pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$",
      "description": "the estimate case id, ESTREQ-YYYYMMDD-xxxxxxxx"
    },
    "estimate_token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,256}$",
      "description": "the token of that estimate case, from estimate_case_create"
    },
    "list_id": {
      "type": "string",
      "pattern": "^PL-[0-9a-f]{32}$",
      "description": "a purchase list id, PL-..."
    },
    "order_id": {
      "type": "string",
      "pattern": "^PI-[0-9a-f]{32}$",
      "description": "an order intent id, PI-..."
    },
    "list_revision": {
      "type": "integer",
      "minimum": 0,
      "description": "the revision of the list as read"
    },
    "version": {
      "type": "integer",
      "minimum": 0,
      "description": "the current_version of the list as read"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,80}$",
      "description": "8 to 80 letters, digits, - or _; the same key replays the same answer"
    }
  },
  "required": [
    "action"
  ],
  "additionalProperties": false
}

Create a real estimate case through the public router. Reuses the connection X-Agent-Key (get one free with POST https://astranl.com/api/agents/register; the api_key is shown once; send it as the X-Agent-Key header of the MCP connection); requester_kind is agent. Save case_id and token securely. language selects human-client output, default nl. Duplicates do not return a token. Processing may be asynchronous.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "uk",
        "pl",
        "de",
        "fr",
        "es",
        "tr",
        "ar",
        "ro",
        "it"
      ],
      "default": "nl"
    },
    "requester_kind": {
      "type": "string",
      "enum": [
        "agent"
      ],
      "default": "agent"
    },
    "postcode": {
      "type": "string",
      "maxLength": 20
    },
    "house_number": {
      "type": [
        "string",
        "integer"
      ]
    },
    "contact_email": {
      "type": "string",
      "maxLength": 254
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

Read the exact public case-status JSON using case_id and its token. Human-client questions and documents retain their language. Deliver an estimate only when release_state is RELEASED; DONE alone is insufficient.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]+$"
    }
  },
  "required": [
    "case_id",
    "token"
  ],
  "additionalProperties": false
}

Submit human answers as a map from question ID to text. The public router validates, merges and queues an operator rerun; submission does not itself spawn processing. Requires the case token.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "answers": {
      "type": "object"
    },
    "version": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "case_id",
    "token",
    "answers"
  ],
  "additionalProperties": false
}

Upload photos or plans as base64 contents, never local paths or URLs. Requires the case token. Public feature flag, type checks, sanitization and quotas apply: 10 files, 15 MiB each, 60 MiB per case. Upload acceptance does not prove incorporation into an existing estimate.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "files": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_. -]{0,119}$"
          },
          "data_base64": {
            "type": "string",
            "minLength": 4,
            "maxLength": 20971520
          }
        },
        "required": [
          "name",
          "data_base64"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "case_id",
    "token",
    "files"
  ],
  "additionalProperties": false
}

Video action=create takes one base64 file up to 250 MiB and reuses the connection agent key (X-Agent-Key header of the MCP connection; get one free with POST https://astranl.com/api/agents/register). action=status takes intake_id and its token only. After case creation, use case_id and case_token with estimate_case_status. Video and case tokens are distinct.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "uk",
        "pl",
        "de",
        "fr",
        "es",
        "tr",
        "ar",
        "ro",
        "it"
      ],
      "default": "nl"
    },
    "requester_kind": {
      "type": "string",
      "enum": [
        "agent"
      ],
      "default": "agent"
    },
    "postcode": {
      "type": "string",
      "maxLength": 20
    },
    "house_number": {
      "type": [
        "string",
        "integer"
      ]
    },
    "contact_email": {
      "type": "string",
      "maxLength": 254
    },
    "action": {
      "type": "string",
      "enum": [
        "create",
        "status"
      ]
    },
    "intake_id": {
      "type": "string",
      "pattern": "^VID-[0-9]{8}-[0-9a-f]{10}$"
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "file": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "pattern": "^[A-Za-z0-9][A-Za-z0-9_. -]{0,119}$"
        },
        "data_base64": {
          "type": "string",
          "minLength": 4,
          "maxLength": 349525336
        }
      },
      "required": [
        "name",
        "data_base64"
      ],
      "additionalProperties": false
    },
    "text": {
      "type": "string",
      "maxLength": 5000
    },
    "speech_language": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    }
  },
  "required": [
    "action"
  ],
  "additionalProperties": false
}

Instant planning cost figure in EUR for one job category in the Netherlands (not a quote; answers in under 2 s). labor_cost = labor_hours x labor_rate x location_mult, always. The rate comes from AstraNL's S_PRICEBASE (CAO wage with employer cost, overhead and profit) or its labour cost canon; hours from CBS-derived norms where AstraNL has one, otherwise a planning factor labelled ASSUMPTION; location_mult is 1.0 with its basis (no sourced regional factor for renovation labour). Each material line says price_source live_read (store, read_at, product link) or indicative (basis and date). No robot price or savings is given without evidence. Sources are in estimate.labour and estimate.materials. For a reviewed estimate of a real job use estimate_case_create, then estimate_case_status and estimate_case_answer; estimate_case_files for photos or plans and estimate_case_video for video intake. Read-only, free.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "painting",
        "cleaning",
        "plumbing",
        "roofing",
        "renovation",
        "electrical",
        "garden",
        "repair",
        "moving",
        "construction",
        "delivery",
        "logistics",
        "energy",
        "solar",
        "hvac",
        "automotive",
        "welding",
        "manufacturing",
        "installation",
        "maintenance",
        "inspection",
        "carpentry",
        "flooring",
        "demolition",
        "insulation",
        "glazing"
      ],
      "description": "Service category. Same enum as create_task."
    },
    "area_m2": {
      "type": "number",
      "description": "Surface area or working volume in square meters. Optional but improves accuracy. For non-area tasks (e.g. plumbing repair) pass 0 or omit.",
      "minimum": 0,
      "maximum": 100000
    },
    "location": {
      "type": "string",
      "description": "City in the Netherlands. Pricing varies by region (Amsterdam tends to be highest). Optional — omitting uses national median.",
      "maxLength": 80
    }
  },
  "required": [
    "category"
  ],
  "additionalProperties": false
}

Search AstraNL coordination data (robots registry, service categories, and merchant parts by keyword). Returns a list of results, each with an id and a short title/snippet, for use with the fetch tool. Read-only. This is the generic discovery entry point expected by agent frameworks.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Free-text search query."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Fetch the full record for a single result id returned by search (robot passport, category detail, or merchant SKU). Read-only.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 120,
      "description": "Result id from search (e.g. robot:DJI-Matrice, sku:16759:Green-flor)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}