Ärikratt

Compare companies

compare_companies

Read-only

Compare up to four legal entities for one year: accounts, tax debt, distress and revenue percentile. 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; a missing tax_debt object is undated and is not absence. Use find_companies to discover codes, or sector_stats for industry medians. Do not look up natural persons.

Input Schema

Name	Required	Description	Default
`year`	No	Financial year. Defaults to the snapshot year.
`registry_codes`	Yes	One to four 8-digit registry codes

Output Schema

Name	Required	Description
`year`	No
`as_of`	Yes
`missing`	No
`partial`	No
`sources`	Yes
`companies`	No
`truncated`	No
`disclaimer`	Yes
`snapshot_id`	Yes
`source_details`	Yes	Full attribution and acquisition evidence: source_metadata(key).
`omitted_sections`	No	Sections 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.

Changed8 schema fields changedOct 29, 2026

addedOutput schema / properties / companies / items / properties / distress / properties / methodology_version

Added value: +{
+  "description": "Methodology version. queries_extra._distress_rising_events and distress_reasons: persisted score observations. Null when the source value or applicable observation is unavailable.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / companies / items / properties / distress / properties / reasons

Added value: +{
+  "description": "Reasons. queries_extra._distress_rising_events and distress_reasons: persisted score observations.",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "component": {
+        "description": "Component. queries_extra._distress_rising_events and distress_reasons: persisted score observations.",
+        "type": "string"
+      },
+      "contribution": {
+        "description": "Contribution. queries_extra._distress_rising_events and distress_reasons: persisted score observations.",
+        "type": "integer"
+      },
+      "event": {
+        "additionalProperties": true,
+        "description": "Event. queries_extra._distress_rising_events and distress_reasons: persisted score observations. Null when the source value or applicable observation is unavailable.",
+        "properties": {
+          "detected_at": {
+            "description": "Detected at. queries_extra._distress_rising_events and distress_reasons: persisted score observations.",
+            "type": "string"
+          },
+          "previous_score": {
+            "description": "Previous score. queries_extra._distress_rising_events and distress_reasons: persisted score observations.",
+            "type": "integer"
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / companies / items / properties / monetary_null_reason

Added value: +{
+  "description": "Monetary null reason. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when no missing-value, suppression or unavailability reason applies.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / companies / items / properties / report_basis

Added value: +{
+  "description": "Report basis. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when the source value or applicable observation is unavailable.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / companies / items / properties / series / properties / employees_q / items / properties

Added value: +{
+  "period": {
+    "description": "Period. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+    "type": "string"
+  },
+  "unit": {
+    "description": "Unit. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+    "type": "string"
+  },
+  "value": {
+    "description": "Value. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when the source value or applicable observation is unavailable.",
+    "type": [
+      "integer",
+      "null"
+    ]
+  }
+}

addedOutput schema / properties / companies / items / properties / tax_debt / properties / left_censored

Added value: +{
+  "description": "True when first_seen is the retention boundary (tax_debt_history_start), so the first listing may be earlier. Not a claim of continuous listing: check episodes and events in tax_debt_history for clears and re-entries. The full comparison tax_debt view includes the key when false.",
+  "type": "boolean"
+}

addedOutput schema / properties / companies / items / properties / tax_debt / properties / series / items / properties

Added value: +{
+  "date": {
+    "description": "Date. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+    "type": "string"
+  },
+  "debt_amount": {
+    "description": "Debt amount. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata. Null when the source value or applicable observation is unavailable.",
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  "unit": {
+    "description": "Unit. queries._company_rows, fill_sector_english_labels and MCP tools: company selection and context metadata.",
+    "type": "string"
+  }
+}

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"
+}

Changed5 schema fields changedOct 18, 2026

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"
+]

Changed3 schema fields changedOct 5, 2026
- 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"
+  ]
+}
```

Changed1 schema field changedOct 4, 2026

removed

Output schema / properties / companies / items / properties / distress / properties / components / properties / adverse_media

Removed value: -{
-  "additionalProperties": true,
-  "properties": {
-    "reason": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "unit": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "value": {
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}

Changed2 schema fields changedSep 27, 2026
- addedOutput schema / properties / companies / items / properties / tax_debt / properties / schedule_end_date
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / companies / items / properties / tax_debt / properties / schedule_end_date_reason
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

Changed1 schema field changedSep 27, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "as_of": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "companies": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "county": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "distress": {
+            "additionalProperties": true,
+            "properties": {
+              "calculated_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "components": {
+                "additionalProperties": true,
+                "properties": {
+                  "adverse_media": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  },
+                  "board_churn": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  },
+                  "financial_health": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  },
+                  "insolvency_announcements": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  },
+                  "license_loss": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  },
+                  "tax_debt": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "reason": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "unit": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "value": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": [
+                      "object",
+                      "null"
+                    ]
+                  }
+                },
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "events": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "date": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "kind": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "previous_score": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "score": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "history": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "date": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "risk_level": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "score": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "rise_threshold": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "risk_level": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "score": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "score_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "score_unit": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "emtak_code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "emtak_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "founded": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "licence_count": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "metrics": {
+            "additionalProperties": true,
+            "properties": {
+              "employees_avg": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "equity": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "net_profit": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "revenue": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "revenue_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "total_assets": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "unit_revenue": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "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"
+            ]
+          },
+          "revenue_percentile": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "series": {
+            "additionalProperties": true,
+            "properties": {
+              "employees_q": {
+                "items": {
+                  "additionalProperties": true,
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "net_profit": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "unit": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "value": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "year": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "revenue": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "reason": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "unit": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "value": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "year": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "state_aid_3y": {
+            "additionalProperties": true,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "tax_debt": {
+            "additionalProperties": true,
+            "properties": {
+              "clear_absences": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "days_on_list": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "debt_amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "debt_amount_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "disputed_amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "disputed_amount_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "episodes": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "events": {
+                "items": {
+                  "additionalProperties": true,
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "first_seen": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_seen": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "oldest_debt_date": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "on_list": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "peak_amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "peak_amount_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "scheduled_amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "scheduled_amount_reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "series": {
+                "items": {
+                  "additionalProperties": true,
+                  "type": [
+                    "object",
+                    "null"
+                  ]
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "snapshot_date": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "threshold_eur": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "tax_last4q": {
+            "additionalProperties": true,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "turnover_last4q": {
+            "additionalProperties": true,
+            "properties": {
+              "period": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "year": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "disclaimer": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "missing": {
+      "items": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "partial": {
+      "type": [
+        "boolean",
+        "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"
+      ]
+    },
+    "year": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "snapshot_id",
+    "as_of",
+    "sources",
+    "disclaimer"
+  ],
+  "title": "compare_companiesOutput",
+  "type": "object"
+}

First observedSep 26, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations already establish this is a safe read-only operation, so the description wisely spends its budget on interpretation semantics instead: what on_list=false with a snapshot_date means, that 'Unknown' means the list was never observed, and that a missing tax_debt object is undated rather than proof of absence. These are non-obvious semantic rules an agent could not infer from the schema or annotations.

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?

Front-loaded with the core comparison scope, then interpretation rules, then alternatives and exclusions. Dense but every sentence carries information; the terminology (on_list, snapshot_date, tax_debt) arrives without definition, which slightly raises reading cost.

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?

An output schema exists, so the description needn't enumerate return values, and it correctly focuses on the edge-case semantics of missing/unknown debt data that the output schema alone would not clarify. Combined with discovery-routing advice, an agent has enough to call this correctly.

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% with both parameters documented (registry_codes with minItems/maxItems, year defaulting to snapshot year). The description only restates 'up to four legal entities' and adds that codes come from find_companies, which is minor added value 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?

States a specific verb and resource ('Compare up to four legal entities for one year') plus the exact dimensions returned (accounts, tax debt, distress, revenue percentile). An agent can immediately tell this is a multi-entity comparison tool rather than a single-entity lookup like get_company.

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

Usage Guidelines4/5

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

Explicitly routes the agent: use find_companies to discover codes and sector_stats for industry medians, and 'Do not look up natural persons' is a clear exclusion. It lacks direct guidance on when to prefer this over get_company or check_counterparty for overlapping single-entity needs, so it falls short of a 5.

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

All Ärikratt tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?