TracePass DPP scope checker
tracepass_scopeCheck what EU law says for a product type matching the facts given: whether it needs a Digital Product Passport, from when, at which level, under which act and article, and the duties of each role. Also reads the catalogue-wide scope report and triggers a refresh run.
HARD RULES — always apply to scope answers:
State what the law says for product types matching the given facts. Not legal advice; never write 'you must' — use product-type phrasing ('LMT batteries need a passport from 18 February 2027, Battery Regulation Art. 77(1)').
Cite the article given for every verdict and duty; a regulation without an article is not a citation.
not_coveredrests on no article: say our rules do not cover the product, name the nearest act given, never cite it as the basis.A date with precision 'quarter', 'month' or 'year' is a plan, NEVER a deadline: write 'planned for Q2 2027 (planned, not law yet)', never 'from', 'by' or 'deadline'.
Relay
not_coveredandneeds_inputas results, never errors.needs_input= blocking questions remain — relayask[]to the user before giving a verdict.Items in an act's
plannedlist are not law yet: label them 'Planned, not law yet' (labelText), with theirwording.data.inScope: yes = passport required; no = none required AND none planned (incl. ESPR-framework-only products, packaging): never say 'not yet' or 'yet'; pending = none today, a passport act is planned: name it fromplanned[]; depends = unanswered facts.ruleStatus: 'needs_recheck': the law behind the act changed and our rules are being re-checked (sincerecheckSince); say so.
Actions (pass via action; {…} is the args object); values, caps and response shapes: resource tracepass://reference/scope.
check — { category?, facts?, role?, placedOnMarket?, lifecycleEvent?, contains?, productId?, passportId?, locale? }. Every plan; counts against the scope-answer cap (~100/day), not the v1 budget (429
scope_answer_cap). Unknownfactskeys: 400. Omitrolefor all roles' duties.catalogue_report — { classification?, category?, act?, changed?, q?, cursor?, limit? (≤500) }. One row per product. Growth plan or above; 403
plan_upgrade_requiredbelow it — tell the user this needs a plan upgrade, do not retry.catalogue_run — {}. Start a refresh run (also nightly); poll with catalogue_run_status. Growth plan. 409 run_in_progress; 429 run_cooldown.
catalogue_run_status — { runId }. Growth plan.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "tracepass_scope"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | ||
| action | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| page | No | ||
| error | No | ||
| items | No | ||
| limit | No | ||
| total | No | ||
| result | No | ||
| message | No | ||
| totalPages | No |