Dutch construction facts with measured accuracy + NL coordination. Never holds third-party funds.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
your task or question in plain words, any language
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.
| Argument | Type | Description |
|---|---|---|
| question* | string | your task or question in plain words, any language |
{
"type": "object",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 400,
"description": "your task or question in plain words, any language"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| city | string | not used; kept for compatibility, AstraNL does not search the register by name |
| purpose | string | optional: the next action you are about to take, for example approve supplier or pay invoice |
| kvk_number | string | Dutch KvK number, 8 digits, as printed on the invoice, quote or website |
| vat_number | string | EU VAT number with country prefix, for example NL810433941B01 |
| company_name | string | the company name exactly as your document or contact states it |
{
"type": "object",
"properties": {
"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"
},
"kvk_number": {
"type": "string",
"maxLength": 12,
"description": "Dutch KvK number, 8 digits, as printed on the invoice, quote or website"
},
"vat_number": {
"type": "string",
"maxLength": 20,
"description": "EU VAT number with country prefix, for example NL810433941B01"
},
"company_name": {
"type": "string",
"maxLength": 200,
"description": "the company name exactly as your document or contact states it"
}
},
"minProperties": 1,
"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.
| Argument | Type | Description |
|---|---|---|
| task_id | string | task id from check_task or a case |
| receipt_id | string | RCPT-n from create_task |
| receipt_key | string | owner key shown once by create_task; without it links are read-only |
{
"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
}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.
No arguments.
{
"type": "object",
"properties": {},
"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. 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.
| Argument | Type | Description |
|---|---|---|
| type | string | |
| limit | integer | events per page, default 25 |
| since_id | string | sequence number or event id cs-... to continue after |
{
"type": "object",
"properties": {
"type": {
"enum": [
"nl.astranl.construction.permits.daily",
"nl.astranl.construction.tender.published",
"nl.astranl.construction.law.upcoming"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "events per page, default 25"
},
"since_id": {
"type": "string",
"maxLength": 40,
"description": "sequence number or event id cs-... to continue after"
}
},
"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 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.
| Argument | Type | Description |
|---|---|---|
| upcoming_days | integer | only rules taking effect within this many days |
{
"type": "object",
"properties": {
"upcoming_days": {
"type": "integer",
"maximum": 3650,
"minimum": 0,
"description": "only rules taking effect within this many days"
}
},
"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. 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.
| Argument | Type | Description |
|---|---|---|
| gemeente | string | municipality / issuing body as published, e.g. Utrecht |
{
"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 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.
| Argument | Type | Description |
|---|---|---|
| site | string | case-insensitive filter on the site label |
{
"type": "object",
"properties": {
"site": {
"type": "string",
"maxLength": 80,
"description": "case-insensitive filter on the site label"
}
},
"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. 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.
| Argument | Type | Description |
|---|---|---|
| days | integer | window in days, default 90 |
| gemeente | string | municipality / issuing body as published, e.g. Utrecht |
| max_municipalities | integer | cap the municipality list for context size, default 40 |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 400,
"minimum": 1,
"description": "window in days, default 90"
},
"gemeente": {
"type": "string",
"maxLength": 80,
"description": "municipality / issuing body as published, e.g. Utrecht"
},
"max_municipalities": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "cap the municipality list for context size, default 40"
}
},
"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. 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.
No arguments.
{
"type": "object",
"properties": {},
"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 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.
No arguments.
{
"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 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.
| Argument | Type | Description |
|---|---|---|
| gemeente | string | municipality / issuing body as published, e.g. Utrecht |
{
"type": "object",
"properties": {
"gemeente": {
"type": "string",
"maxLength": 80,
"description": "municipality / issuing body as published, e.g. Utrecht"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| need* | string | what must happen, in plain words |
| proof | string | what evidence closes the task, agreed before work starts |
| deadline | string | by when; ISO date or plain words |
| location | string | city or address in the Netherlands |
| synthetic | boolean | true marks a test that must never be counted or executed |
| budget_cents | integer | budget in euro cents |
| reply_channel | string | email or https URL where AstraNL may answer you |
{
"type": "object",
"required": [
"need"
],
"properties": {
"need": {
"type": "string",
"maxLength": 800,
"description": "what must happen, in plain words"
},
"proof": {
"type": "string",
"maxLength": 400,
"description": "what evidence closes the task, agreed before work starts"
},
"deadline": {
"type": "string",
"maxLength": 100,
"description": "by when; ISO date or plain words"
},
"location": {
"type": "string",
"maxLength": 200,
"description": "city or address in the Netherlands"
},
"synthetic": {
"type": "boolean",
"description": "true marks a test that must never be counted or executed"
},
"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"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| token* | string | |
| answers* | object | |
| case_id* | string | |
| version | integer |
{
"type": "object",
"required": [
"case_id",
"token",
"answers"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256,
"minLength": 1
},
"answers": {
"type": "object"
},
"case_id": {
"type": "string",
"pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
},
"version": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| text* | string | |
| language | string | |
| postcode | string | |
| house_number | string | integer | |
| contact_email | string | |
| requester_kind | string |
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 1
},
"language": {
"enum": [
"en",
"nl",
"uk",
"pl",
"de",
"fr",
"es",
"tr",
"ar",
"ro",
"it"
],
"type": "string",
"default": "nl"
},
"postcode": {
"type": "string",
"maxLength": 20
},
"house_number": {
"type": [
"string",
"integer"
]
},
"contact_email": {
"type": "string",
"maxLength": 254
},
"requester_kind": {
"enum": [
"agent"
],
"type": "string",
"default": "agent"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| files* | array | |
| token* | string | |
| case_id* | string |
{
"type": "object",
"required": [
"case_id",
"token",
"files"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"data_base64"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9_. -]{0,119}$"
},
"data_base64": {
"type": "string",
"maxLength": 20971520,
"minLength": 4
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"token": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256,
"minLength": 1
},
"case_id": {
"type": "string",
"pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| token* | string | |
| case_id* | string |
{
"type": "object",
"required": [
"case_id",
"token"
],
"properties": {
"token": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256,
"minLength": 1
},
"case_id": {
"type": "string",
"pattern": "^ESTREQ-[0-9]{8}-[0-9a-f]{8}$"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| file | object | |
| text | string | |
| token | string | |
| action* | string | |
| language | string | |
| postcode | string | |
| intake_id | string | |
| house_number | string | integer | |
| contact_email | string | |
| requester_kind | string | |
| speech_language | string |
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.
| Argument | Type | Description |
|---|---|---|
| area_m2 | number | Surface area or working volume in square meters. Optional but improves accuracy. For non-area tasks (e.g. plumbing repair) pass 0 or omit. |
| category* | string | Service category. Same enum as create_task. |
| location | string | City in the Netherlands. Pricing varies by region (Amsterdam tends to be highest). Optional — omitting uses national median. |
{
"type": "object",
"required": [
"category"
],
"properties": {
"area_m2": {
"type": "number",
"maximum": 100000,
"minimum": 0,
"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."
},
"category": {
"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"
],
"type": "string",
"description": "Service category. Same enum as create_task."
},
"location": {
"type": "string",
"maxLength": 80,
"description": "City in the Netherlands. Pricing varies by region (Amsterdam tends to be highest). Optional — omitting uses national median."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| id* | string | Result id from search (e.g. robot:DJI-Matrice, sku:16759:Green-flor). |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "Result id from search (e.g. robot:DJI-Matrice, sku:16759:Green-flor)."
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | task id, action id or receipt id |
{
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"maxLength": 40,
"description": "task id, action id or receipt id"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Short subject, product keywords or identifier; all product keyword groups must match. |
| claims | array | v2 only. Each claim names a record id from a previous result, a predicate and the expected value. |
| source | string | v1: auto, materials, public_tenders, protocol_identity or all. v2 requires an explicit materials, public_tenders or protocol_identity. |
| protocol | string | Omit for the v1 context call. Set to astranl.reality-link.v2 together with claims to check typed claims against source records. |
| budget_ms | integer | |
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.
| Argument | Type | Description |
|---|---|---|
| doi* | string | the DOI of the work, bare or as a doi.org link, e.g. 10.1038/s41593-021-00895-5 |
{
"type": "object",
"required": [
"doi"
],
"properties": {
"doi": {
"type": "string",
"maxLength": 300,
"minLength": 7,
"description": "the DOI of the work, bare or as a doi.org link, e.g. 10.1038/s41593-021-00895-5"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| mpn* | string | manufacturer part number, exactly as printed by the maker, e.g. 1756-L85E |
| manufacturer | string | optional maker name, e.g. Allen-Bradley; offers from other makers are then dropped |
{
"type": "object",
"required": [
"mpn"
],
"properties": {
"mpn": {
"type": "string",
"maxLength": 80,
"minLength": 3,
"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"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| municipality* | string | Dutch municipality name or CBS code, e.g. Zaanstad or GM0479 |
| bouwkosten_eur | number | planned construction cost excluding VAT in euro; default 50000 |
{
"type": "object",
"required": [
"municipality"
],
"properties": {
"municipality": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Dutch municipality name or CBS code, e.g. Zaanstad or GM0479"
},
"bouwkosten_eur": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "planned construction cost excluding VAT in euro; default 50000"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| check_id* | string | the check_id returned by check_counterparty_nl, ASTRA-K- and 16 characters |
{
"type": "object",
"required": [
"check_id"
],
"properties": {
"check_id": {
"type": "string",
"maxLength": 40,
"description": "the check_id returned by check_counterparty_nl, ASTRA-K- and 16 characters"
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Free-text search query. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "Free-text search query."
}
},
"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.
| Argument | Type | Description |
|---|---|---|
| ref* | string | Any AstraNL reference: action receipt ASTRA-A-..., policy receipt ASTRA-R-..., consumption ASTRA-C-..., log event alk_..., attestation att_/atr_..., ingress receipt RCPT-n |
{
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"maxLength": 64,
"minLength": 4,
"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"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"action"
],
"properties": {
"file": {
"type": "object",
"required": [
"name",
"data_base64"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9_. -]{0,119}$"
},
"data_base64": {
"type": "string",
"maxLength": 349525336,
"minLength": 4
}
},
"additionalProperties": false
},
"text": {
"type": "string",
"maxLength": 5000
},
"token": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 256,
"minLength": 1
},
"action": {
"enum": [
"create",
"status"
],
"type": "string"
},
"language": {
"enum": [
"en",
"nl",
"uk",
"pl",
"de",
"fr",
"es",
"tr",
"ar",
"ro",
"it"
],
"type": "string",
"default": "nl"
},
"postcode": {
"type": "string",
"maxLength": 20
},
"intake_id": {
"type": "string",
"pattern": "^VID-[0-9]{8}-[0-9a-f]{10}$"
},
"house_number": {
"type": [
"string",
"integer"
]
},
"contact_email": {
"type": "string",
"maxLength": 254
},
"requester_kind": {
"enum": [
"agent"
],
"type": "string",
"default": "agent"
},
"speech_language": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"additionalProperties": false
}| max_items |
| integer |
| v1 only; v2 looks up at most 12 records and refuses max_items. |
| max_age_seconds | integer |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 1600,
"minLength": 2,
"description": "Short subject, product keywords or identifier; all product keyword groups must match."
},
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"record_id",
"predicate",
"expected"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"expected": {
"anyOf": [
{
"type": "string",
"maxLength": 600,
"minLength": 1
},
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^\\d{1,10}(\\.\\d{1,2})?$"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
}
]
},
"predicate": {
"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"
],
"type": "string"
},
"record_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1,
"description": "v2 only. Each claim names a record id from a previous result, a predicate and the expected value."
},
"source": {
"enum": [
"auto",
"materials",
"public_tenders",
"protocol_identity",
"all"
],
"type": "string",
"default": "auto",
"description": "v1: auto, materials, public_tenders, protocol_identity or all. v2 requires an explicit materials, public_tenders or protocol_identity."
},
"protocol": {
"enum": [
"astranl.reality-link.v2"
],
"type": "string",
"description": "Omit for the v1 context call. Set to astranl.reality-link.v2 together with claims to check typed claims against source records."
},
"budget_ms": {
"type": "integer",
"default": 750,
"maximum": 1500,
"minimum": 50
},
"max_items": {
"type": "integer",
"default": 6,
"maximum": 12,
"minimum": 1,
"description": "v1 only; v2 looks up at most 12 records and refuses max_items."
},
"max_age_seconds": {
"type": "integer",
"default": 86400,
"maximum": 604800,
"minimum": 60
}
},
"additionalProperties": false
}