ask_astranl
Route a task to the right AstraNL tool
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.
輸入參數question必填
check_counterparty_nl
Check a Dutch or EU counterparty
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.
輸入參數citypurposekvk_numbervat_numbercompany_name
record_counterparty_check
Record a counterparty check for later verification
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.
輸入參數check_id必填
create_task
Create a coordinated real-world task
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.
輸入參數need必填proofdeadlinelocationsyntheticbudget_centsreply_channel
check_task
Check task state
Current state of a task or ingress receipt from create_task, and who must act next. Returns only what is recorded; infers nothing.
輸入參數task_idreceipt_idreceipt_key
get_evidence
Get verifiable evidence
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.
輸入參數task_id必填
verify_astranl
Verify an AstraNL reference
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.
輸入參數ref必填
ground_astranl
Source-linked context for an answer
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.
輸入參數query必填claimssourceprotocolbudget_msmax_itemsmax_age_seconds
ground_component
Ground a component in live market reality
Ground a machine, robot or industrial automation component in live market reality with ONE read-only 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.
輸入參數mpn必填manufacturer
ground_citation
Check a scientific reference for retraction and correction notices
Check one scientific reference before you reuse or cite it, with ONE read-only 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.
輸入參數doi必填
construction_summary
construction summary
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. Read-only aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
無需輸入參數。
construction_permits
construction permits
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. Read-only aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數daysgemeentemax_municipalities
construction_leadtimes
construction leadtimes
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. Read-only aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數gemeente
construction_tenders
construction tenders
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 aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
無需輸入參數。
construction_laws
construction laws
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 aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數upcoming_days
construction_economy
construction economy
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 aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
無需輸入參數。
construction_zones
construction zones
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 aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數gemeente
construction_natura
construction natura
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 aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數site
construction_events
construction events
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. Read-only aggregates: 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). Every answer carries source provenance (source, source_url, licence, as_of/retrieved_at, method, status) and an exposure block.
輸入參數typelimitsince_id
nl_municipal_build_rules
Dutch municipal permit fee and skip rule for a building job
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.
輸入參數municipality必填bouwkosten_eur
check_material
Check a building material in live store reality
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.
輸入參數ref必填
check_estimate_materials
Check the materials of an estimate
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.
輸入參數token必填case_id必填
Create a real estimate case through the public router. Reuses the connection X-Agent-Key; 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.
輸入參數text必填languagepostcodehouse_numbercontact_emailrequester_kind
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.
輸入參數token必填case_id必填
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.
輸入參數token必填answers必填case_id必填version
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.
輸入參數files必填token必填case_id必填
Video action=create takes one base64 file up to 250 MiB and reuses the connection agent key. 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.
輸入參數filetexttokenaction必填languagepostcodeintake_idhouse_numbercontact_emailrequester_kindspeech_language
estimate_cost
Estimate task cost
Legacy model-based cost figure in EUR, with human-provider and robot-automation comparisons. AstraNL currently has zero recorded real price observations for this service. This tool does not create an estimate case and does not provide a reviewed quotation. For the real case engine use estimate_case_create, then estimate_case_status and estimate_case_answer; use estimate_case_files for photos/plans and estimate_case_video for video intake. Do not invent dimensions. Legacy arguments and response fields remain unchanged.
輸入參數area_m2category必填location
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.
輸入參數query必填
fetch
Fetch AstraNL record
Fetch the full record for a single result id returned by search (robot passport, category detail, or merchant SKU). id 'context' returns the AstraNL continuation packet: live state, open mandates and recent sessions, the same text as https://astranl.com/api/context.md. Read-only.
輸入參數id必填