Skip to main content
Glama

Watch companies

watch_companies
Read-only

Typed changes for a bounded list of legal-entity registry codes: name, status, capital, succession, tax debt and distress. Returns companies needing attention, with filing status and current tax debt. on_list false with snapshot_date means not on the EMTA debt list ≥100 € as of that date. Unknown applies only when the list was not observed and is not assurance of absence. Use check_counterparty for one code, or get_company sections tax_debt_history or distress_trend for deeper history. Do not look up natural persons.

Input Schema

NameRequiredDescriptionDefault
sinceNoOpaque change cursor (event id) or previous snapshot_id. Omit for the full typed change list in this snapshot.
cursorNoOpaque cursor from a previous next_cursor for the next page
registry_codesYesOne to fifty 8-digit legal-entity registry codes

Output Schema

NameRequiredDescriptionDefault
rowsNo
as_ofYes
sinceNo
sourcesYes
requestedNo
row_countNo
truncatedNo
disclaimerYes
next_cursorNo
snapshot_idYes
source_detailsYesFull attribution and acquisition evidence: source_metadata(key).
omitted_sectionsNoSections removed to fit the response budget, including default sections. Request one named section to retrieve it. Present only when truncated.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / sources / items / properties / as_of_basis
      Added value: +{
      +  "description": "As of basis. privacy._sources: compact source attribution; absent clocks are omitted.",
      +  "type": "string"
      +}
  2. Changed5 schema fields changed
    • addedOutput schema / properties / omitted_sections
      Added value: +{
      +  "description": "Sections removed to fit the response budget, including default sections. Request one named section to retrieve it. Present only when truncated.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / source_details
      Added value: +{
      +  "description": "Full attribution and acquisition evidence: source_metadata(key).",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / sources / items / properties / as_of
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / sources / items / properties / key
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "snapshot_id",
      -  "as_of",
      -  "sources",
      -  "disclaimer"
      -]New value: +[
      +  "snapshot_id",
      +  "as_of",
      +  "sources",
      +  "source_details",
      +  "disclaimer"
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / registry_codes / description
      Previous value: -"One to fifty 8-digit registry codes (Büroo change feed)"New value: +"One to fifty 8-digit legal-entity registry codes"
  4. Changed3 schema fields changed
    • addedOutput schema / properties / sources / items / properties / licence_checked_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / sources / items / properties / licence_evidence_url
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / sources / items / properties / rights_status
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "as_of": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "disclaimer": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "next_cursor": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "requested": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "row_count": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "rows": {
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "changes": {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "date": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "detail": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "id": {
      +                  "type": [
      +                    "number",
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "kind": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "text": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": [
      +                "object",
      +                "null"
      +              ]
      +            },
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "county": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "emtak": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "registry_code": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "report_status": {
      +            "additionalProperties": true,
      +            "properties": {
      +              "filed": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "latest_year": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "latest_year_reason": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "next_due": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "overdue_days": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "overdue_days_reason": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "period": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "status": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "unit": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "tax_debt": {
      +            "additionalProperties": true,
      +            "properties": {
      +              "amount": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "as_of": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "debt_amount": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "on_list": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "since": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "snapshot_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sources": {
      +      "items": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "attribution": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "licence": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "licence_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "truncated": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "snapshot_id",
      +    "as_of",
      +    "sources",
      +    "disclaimer"
      +  ],
      +  "title": "watch_companiesOutput",
      +  "type": "object"
      +}
  6. Added

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, non-destructive, closed-world behavior, so the description does not need to restate safety. It adds meaningful semantic context about the EMTA debt-list interpretation and the difference between on_list false and Unknown, which prevents common misinterpretations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with purpose and return behavior, then moves to semantic caveats and alternatives. It is dense but well organized, with only a small amount of extra interpretive text that earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With full schema coverage, annotations, and an output schema, the definition is nearly self-sufficient. The description adds important domain caveats about Unknown and on_list false, though it could say slightly more about pagination or change-cursor semantics if those are not fully covered elsewhere.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the parameter descriptions already define since, cursor, and registry_codes. The tool description reinforces the bounded-list nature but adds little parameter-specific syntax or format guidance beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb-and-resource pattern: typed changes for a bounded list of legal-entity registry codes, covering name, status, capital, succession, tax debt, and distress. It also distinguishes this watchlist-style query from alternatives like check_counterparty and get_company, so an agent can identify the tool without opening another schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly routes single-code lookups to check_counterparty and deeper history lookups to get_company sections, and it warns against natural-person lookups. The when-to-use and when-not-to-use boundaries are clearly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources