get_providerGet one published provider by ID, including selected package, historical/unknown price status, location evidence and source URLs.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Exact provider ID returned by search_providers. |
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| providers | Yes | ||
| disclosure | Yes | ||
| limitations | Yes |
Changes observed during successful MCP inspections.
Output schema / properties / providers / itemsPrevious value: -{
- "additionalProperties": false,
- "description": "",
- "properties": {
- "category": {
- "description": "Service category.",
- "type": "string"
- },
- "description": {
- "description": "Public summary.",
- "type": "string"
- },
- "id": {
- "description": "Stable provider ID.",
- "type": "string"
- },
- "location": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "backup": {
- "description": "Backup evidence and uncertainties.",
- "type": "string"
- },
- "documented": {
- "description": "Primary location evidence only, not proof for all subprocessors or backups.",
- "type": "boolean"
- },
- "limitations": {
- "description": "Limits of the location evidence.",
- "type": "string"
- },
- "passport": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- },
- "primary": {
- "description": "Primary data location.",
- "type": "string"
- },
- "region": {
- "description": "eu, eu-ch or unknown; Switzerland is separate from the EU.",
- "type": "string"
- }
- },
- "required": [
- "region",
- "documented",
- "primary",
- "backup",
- "limitations",
- "passport"
- ],
- "type": "object"
- },
- "migration": {
- "description": "",
- "items": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "refs": {
- "description": "",
- "items": {
- "description": "ID in this provider sources array.",
- "type": "string"
- },
- "type": "array"
- },
- "text": {
- "description": "Public editorial claim.",
- "type": "string"
- }
- },
- "required": [
- "text",
- "refs"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "description": "Provider name.",
- "type": "string"
- },
- "package": {
- "description": "Exact selected package.",
- "type": "string"
- },
- "price": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "checked": {
- "description": "Original source review date; not export time.",
- "format": "date",
- "type": [
- "string",
- "null"
- ]
- },
- "conditions": {
- "description": "Displayed price conditions, including historic status.",
- "type": "string"
- },
- "label": {
- "description": "Public displayed price.",
- "type": "string"
- },
- "offer": {
- "additionalProperties": false,
- "description": "Selected price basis only; other contract options may be explained on the profile.",
- "properties": {
- "billingMonths": {
- "description": "Billing interval in months, not necessarily the minimum contract duration.",
- "minimum": 0,
- "type": "integer"
- },
- "conditions": {
- "description": "Scope, billing unit, assumptions and limitations.",
- "type": "string"
- },
- "currency": {
- "description": "Currency of source amounts.",
- "enum": [
- "EUR"
- ],
- "type": "string"
- },
- "extras": {
- "description": "",
- "items": {
- "description": "Excluded or unconfirmed additional cost.",
- "type": "string"
- },
- "type": "array"
- },
- "introCents": {
- "description": "Source monthly or usage-unit introductory amount in eurocents, before VAT conversion.",
- "minimum": 0,
- "type": "integer"
- },
- "introMonths": {
- "description": "Months at the introductory rate; zero means no introductory period.",
- "minimum": 0,
- "type": "integer"
- },
- "kind": {
- "description": "Products with different billing models are not interchangeable.",
- "enum": [
- "subscription",
- "usage",
- "free"
- ],
- "type": "string"
- },
- "promo": {
- "description": "Whether the recorded offer is promotional.",
- "type": "boolean"
- },
- "promoEnd": {
- "description": "Recorded promotion end date YYYY-MM-DD, or empty if not specified.",
- "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
- "type": "string"
- },
- "regularCents": {
- "description": "Source monthly or usage-unit renewal amount in eurocents; not a future price guarantee.",
- "minimum": 0,
- "type": "integer"
- },
- "setupCents": {
- "description": "One-time source setup fee; null means unconfirmed, not zero.",
- "minimum": 0,
- "type": [
- "integer",
- "null"
- ]
- },
- "term": {
- "description": "Contract, prepayment and renewal conditions.",
- "type": "string"
- },
- "vat": {
- "description": "gross: VAT included; net21: exclude 21 percent VAT; assumed_gross: inclusion assumed, not confirmed.",
- "enum": [
- "gross",
- "net21",
- "assumed_gross",
- "unknown"
- ],
- "type": "string"
- }
- },
- "required": [
- "currency",
- "kind",
- "vat",
- "introCents",
- "introMonths",
- "regularCents",
- "billingMonths",
- "setupCents",
- "promo",
- "promoEnd",
- "term",
- "conditions",
- "extras"
- ],
- "type": [
- "object",
- "null"
- ]
- },
- "renewalLabel": {
- "description": "Public renewal description.",
- "type": "string"
- },
- "sources": {
- "description": "Official evidence for the selected price basis.",
- "items": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- },
- "type": "array"
- },
- "status": {
- "description": "checked: approved within validity rules; historical: last approved basis, not confirmed current; unknown: no publishable basis.",
- "enum": [
- "checked",
- "historical",
- "unknown"
- ],
- "type": "string"
- },
- "term": {
- "description": "Contract and billing conditions.",
- "type": "string"
- }
- },
- "required": [
- "label",
- "renewalLabel",
- "conditions",
- "term",
- "status",
- "checked",
- "offer",
- "sources"
- ],
- "type": "object"
- },
- "profile": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- },
- "purchase": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "affiliateAvailable": {
- "description": "Profile may contain a disclosed affiliate link.",
- "type": "boolean"
- },
- "checkout": {
- "description": "Orders and payments occur with the provider, not HostDirect.",
- "type": "string"
- },
- "profile": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- },
- "providerUrl": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "profile",
- "providerUrl",
- "affiliateAvailable",
- "checkout"
- ],
- "type": "object"
- },
- "sources": {
- "description": "",
- "items": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "checked": {
- "description": "Original source review date; not export time.",
- "format": "date",
- "type": "string"
- },
- "id": {
- "description": "Stable source reference.",
- "type": "string"
- },
- "label": {
- "description": "Source title.",
- "type": "string"
- },
- "url": {
- "description": "Absolute public URL.",
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "id",
- "label",
- "url",
- "checked"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "specifications": {
- "description": "",
- "items": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "refs": {
- "description": "",
- "items": {
- "description": "ID in this provider sources array.",
- "type": "string"
- },
- "type": "array"
- },
- "text": {
- "description": "Public editorial claim.",
- "type": "string"
- }
- },
- "required": [
- "text",
- "refs"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "suitable": {
- "description": "",
- "items": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "refs": {
- "description": "",
- "items": {
- "description": "ID in this provider sources array.",
- "type": "string"
- },
- "type": "array"
- },
- "text": {
- "description": "Public editorial claim.",
- "type": "string"
- }
- },
- "required": [
- "text",
- "refs"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "unsuitable": {
- "description": "",
- "items": {
- "additionalProperties": false,
- "description": "",
- "properties": {
- "refs": {
- "description": "",
- "items": {
- "description": "ID in this provider sources array.",
- "type": "string"
- },
- "type": "array"
- },
- "text": {
- "description": "Public editorial claim.",
- "type": "string"
- }
- },
- "required": [
- "text",
- "refs"
- ],
- "type": "object"
- },
- "type": "array"
- }
- },
- "required": [
- "id",
- "name",
- "package",
- "category",
- "description",
- "profile",
- "price",
- "location",
- "suitable",
- "unsuitable",
- "specifications",
- "migration",
- "sources",
- "purchase"
- ],
- "type": "object"
-}New value: +nullDoes the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, openWorldHint=false and destructiveHint=false, so the safety profile is covered. The description adds meaningful context beyond that — the record is limited to 'published' providers and includes price-status and location evidence — but it is silent on failure behavior, such as what happens for an unpublished or unknown ID.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One front-loaded sentence with the verb and resource first, followed by the notable fields returned; nothing is redundant. The trailing field list is slightly dense but each item signals a distinct aspect of the payload.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description need not explain return values, and annotations cover the safety semantics, so remaining gaps are small. The main omission is error/not-found behavior and any hint about when this lookup is preferable to the sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the single 'id' parameter already carries its pattern, length bounds, and the note that it comes from search_providers. The description's only added meaning is the 'published' qualifier on which IDs are valid, which is a modest but real contribution over the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get one published provider by ID') and scopes the result to a single record, which contrasts implicitly with the plural listing/compare siblings. It does not name search_providers or compare_providers as alternatives, so the differentiation is left partly to inference.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is only implied: the singular 'one ... by ID' suggests a detail lookup after a search, but the description never states when to choose this over search_providers or compare_providers. No exclusions or prerequisites (e.g. what to do with an ID that isn't published) are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.