Skip to main content
Glama

Search published business passports

search_passports
Read-onlyIdempotent

Search AI MAXX published company, service and place records by a specific customer need or business name. Returns source links, review dates, arrival information and availability caveats. This catalogue is limited to its listed businesses; it does not search the whole web or guarantee availability. Specify country_code when the user names a country.

Input Schema

NameRequiredDescriptionDefault
kindNo
limitNo
queryYesSpecific need or name. English and Russian intent matching are supported; translate other-language intent to English without changing location or constraints.
country_codeNoRequested ISO country code. A country without records returns no matches.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "coverage": {
      +          "properties": {
      +            "companies": {
      +              "items": {
      +                "properties": {
      +                  "country_code": {
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "passport_id": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "name",
      +                  "country_code",
      +                  "passport_id"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "company_records": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "country_codes": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "place_records": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "scope": {
      +              "type": "string"
      +            },
      +            "searchable_records": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "service_records": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "withheld_unverified_records": {
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "companies",
      +            "country_codes",
      +            "searchable_records",
      +            "company_records",
      +            "service_records",
      +            "place_records",
      +            "withheld_unverified_records",
      +            "scope"
      +          ],
      +          "type": "object"
      +        },
      +        "limitations": {
      +          "type": "string"
      +        },
      +        "matches": {
      +          "items": {
      +            "properties": {
      +              "arrival": {
      +                "type": [
      +                  "object",
      +                  "null"
      +                ]
      +              },
      +              "company": {
      +                "type": "string"
      +              },
      +              "country_code": {
      +                "type": "string"
      +              },
      +              "description": {
      +                "type": "string"
      +              },
      +              "enquiry": {
      +                "type": "string"
      +              },
      +              "id": {
      +                "type": "string"
      +              },
      +              "kind": {
      +                "enum": [
      +                  "company",
      +                  "service",
      +                  "place"
      +                ],
      +                "type": "string"
      +              },
      +              "location_media": {
      +                "type": [
      +                  "object",
      +                  "null"
      +                ]
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "navigation": {
      +                "type": [
      +                  "object",
      +                  "null"
      +                ]
      +              },
      +              "opening_information": {
      +                "type": "string"
      +              },
      +              "passport_url": {
      +                "type": "string"
      +              },
      +              "reviewed_at": {
      +                "type": "string"
      +              },
      +              "source": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "name",
      +              "company",
      +              "country_code",
      +              "passport_url",
      +              "source",
      +              "reviewed_at",
      +              "description"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "total_matches": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "matches",
      +        "total_matches",
      +        "coverage",
      +        "limitations"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "properties": {
      +        "error": {
      +          "type": "string"
      +        },
      +        "fallback_tool": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "type": "string"
      +        },
      +        "recovery": {
      +          "properties": {
      +            "automatic_model_retry": {
      +              "type": "string"
      +            },
      +            "catalogue": {
      +              "type": "string"
      +            },
      +            "mode": {
      +              "type": "string"
      +            },
      +            "reason": {
      +              "type": "string"
      +            },
      +            "source_index": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "mode",
      +            "automatic_model_retry"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already establish read-only, closed-world, idempotent, and non-destructive behavior. The description adds behavioral context beyond annotations by stating what the result includes, noting that the catalogue is limited to listed businesses, and explicitly disclaiming availability guarantees.

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

Conciseness5/5

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

The description is four tightly focused sentences, front-loading the core purpose and then layering scope limits, return content, and a key parameter hint. Every sentence contributes information without repetition or filler.

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 a rich output schema and strong annotations, the description does not need to cover return structure or safety details. It adequately covers purpose, catalogue limits, and country_code behavior, though it omits any sibling-tool routing guidance that could matter in a crowded toolset.

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 50%, with query and country_code partly documented in the schema. The description adds guidance for country_code and implicitly maps to the kind enum by naming company, service, and place records, but it does not explain limit or fully compensate for the uncovered parameter semantics.

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

Purpose4/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: search AI MAXX published company, service and place records. It clearly communicates scope in the title and body, but it does not explicitly distinguish this tool from siblings such as get_passport or resolve_customer_need, so sibling differentiation is left to the agent.

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

Usage Guidelines3/5

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

It gives clear use context by saying the search is for a specific customer need or business name, and it adds useful scope exclusions such as not searching the whole web. However, it never names alternative tools or explains when to prefer this tool over related siblings, leaving routing to inference.

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