JP Data
Server Details
Japan, Korea and UK official data for AI agents: filings, FX, weather, travel, patents, AI tools.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 3/5 across 13 of 13 tools scored. Lowest: 1.5/5.
Each tool has a clearly distinct purpose with no overlap. Japan-specific tools cover different aspects (anime, events, onsen, rail, food, filings) and generic tools (memory, translate, summarize) are separate. Paid status is clearly marked.
Naming uses both 'japan_' and 'jp_' prefixes, and two tools (anime_pilgrimage, world_city_guide) lack any prefix. While still readable, the inconsistency could cause confusion.
13 tools is within the ideal range. The count feels appropriate for the breadth of functionality offered, neither too sparse nor overwhelming.
For a 'JP Data' server, coverage of Japanese data is partial (missing weather, news, demographics) and the inclusion of generic utilities dilutes focus. Several potential Japan-related tools are absent.
Available Tools
13 toolsanime_pilgrimageDInspect
Real-world locations featured in popular anime (seichi junrei).
| Name | Required | Description | Default |
|---|---|---|---|
| q | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description provides no behavioral information beyond the topic. It does not mention if the tool performs a search, returns a list, or any side effects. Since no annotations are present, the description carries full burden but adds no behavioral context.
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?
The description is extremely short (one noun phrase) but lacks structure. It does not use the front-loaded format effectively, and while brevity is generally good, here it results in under-specification. There is no sentence explaining the tool's operation.
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?
Given the tool's simplicity (one param, no output schema, no annotations), the description is still insufficient. It does not cover the parameter purpose, return value, or usage context. The agent cannot determine what input to provide or what output to expect.
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?
The sole parameter 'q' is not mentioned in the description, and the schema provides no description or constraints. With 0% schema coverage, the description fails to add any meaning to the parameter, leaving the agent unable to construct a valid query.
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?
The description is a noun phrase stating what the tool is about ('real-world locations featured in popular anime'), but does not specify the action (e.g., search, list, retrieve). Without a verb, the purpose is ambiguous, especially with a single 'q' parameter that is not described. Sibling tools like 'japan_events' have clear action implications, but this one lacks operational clarity.
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?
No guidance is provided on when to use this tool versus alternatives like japan_events or world_city_guide. The description does not indicate typical use cases or prerequisites. With zero schema coverage, the agent has no context for when to invoke it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
japan_eventsCInspect
Japanese festivals and annual events by month (1-12).
| Name | Required | Description | Default |
|---|---|---|---|
| month | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose safety and behavior. It only mentions month-based filtering, but does not state whether it is read-only, what data is returned, or any prerequisites.
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?
The description is extremely concise, but given the low schema and annotation coverage, it could benefit from slightly more detail to be truly effective.
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 one parameter and no output schema, the description is minimally complete. It does not explain what the output looks like (list, objects, etc.) or any edge cases.
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?
The description adds the meaning that 'month' should be a number from 1 to 12, which is not in the schema. However, formatted details (e.g., '01' vs '1') are lacking, and coverage is low.
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?
The description clearly states it provides Japanese festivals and annual events by month. It distinguishes from sibling tools like anime_pilgrimage and japan_onsen_guide, which cover different topics.
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?
No guidance on when to use this tool versus alternatives. There is no mention of context, exclusions, or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
japan_onsen_guideCInspect
Famous Japanese hot spring (onsen) towns with water type, features, access.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so description must cover behavioral traits. It only states the content (water type, features, access) but does not disclose query behavior, result format, or any side effects.
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?
The description is a single sentence, which is concise but lacks substance. It is front-loaded but insufficiently informative.
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 no output schema, no annotations, and an undocumented parameter, the description fails to provide enough context for correct invocation or understanding of what the tool returns.
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?
No description for the single parameter 'q' in the schema (0% coverage) and the tool description does not explain its purpose or expected values.
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?
The description indicates the tool provides information about onsen towns, but lacks an action verb (e.g., 'list', 'find', 'search'). The purpose is inferred rather than stated explicitly.
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?
No guidance on when to use this tool versus sibling tools like japan_regional_food or japan_events. No when-to-use or when-not-to-use context provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
japan_rail_linesCInspect
Major Japanese railway lines and key stations.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries full burden. It does not disclose any behavioral traits such as read-only nature, database backend, or parameter behavior (e.g., optional query). The description is too brief to be informative.
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?
The description is very short, which is concise but lacks structure. It front-loads the subject but omits essential details like parameter usage. For a simple tool, it is acceptable in length but not in content.
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?
Given the tool has one optional parameter and no output schema, the description is incomplete. It does not explain the return value, query semantics, or scope. A complete description would at least define the 'q' parameter.
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?
The input schema has one parameter 'q' with 0% schema description coverage. The description fails to explain what 'q' means or how it should be used. It adds no value beyond 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?
The description clearly states the subject matter (major Japanese railway lines and key stations), which is distinct from sibling tools like anime_pilgrimage or japan_events. However, it does not specify the action (e.g., list, search, get details), making it slightly vague.
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?
No guidance is provided on when to use this tool versus alternatives. The description does not mention context, prerequisites, or exclusions. The sibling tools are all Japan-related but no differentiation is offered.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
japan_regional_foodAInspect
Japanese regional specialty dishes (sushi, ramen, wagyu, curry, gyoza...) with origin and description. Optional keyword filter.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description must cover behavioral traits. It mentions optional keyword filter and that it returns origin and description, but does not disclose auth needs, rate limits, or exact response format. Adequate for a simple query tool.
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?
Single sentence that front-loads the key information: what the tool provides, examples, and parameter usage. No wasted words.
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?
For a simple tool with one optional parameter and no output schema, the description covers the main idea but lacks detail on the return structure (e.g., format of each dish entry). Could be more complete by hinting at response fields.
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 0%, so description must add meaning. The description explains that the 'q' parameter is an optional keyword filter, which is clear and sufficient for a single string parameter.
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?
Clearly states it provides Japanese regional specialty dishes with origin and description, lists examples, and mentions an optional keyword filter. Distinct from all sibling tools which cover different domains.
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?
Implies usage for querying Japanese regional food information, but provides no explicit when-to-use or when-not-to-use guidance. No mention of alternatives or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_company_briefAInspect
AI company research brief from official registries (Japan EDINET, Korea DART, UK Companies House). PAID TOOL: costs $0.25 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| country | No | JP | KR | UK |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses the paid nature and data sources, but lacks details on behavior like error handling, rate limits, response format, or data freshness.
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?
The description is two sentences long, front-loading the core purpose and cost. There is no superfluous information.
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?
For a simple 2-parameter tool with no output schema, the description covers the basic purpose and cost. However, it lacks completeness on what the output (brief) contains or error scenarios.
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?
The description adds no additional meaning beyond the input schema: it mentions country values (JP/KR/UK) which are already in the schema. It does not elaborate on the 'name' parameter. Schema coverage is only 50%.
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?
The description clearly states the tool provides AI company research briefs from specific official registries (Japan EDINET, Korea DART, UK Companies House). It distinguishes from siblings like japan_events or anime_pilgrimage which are travel-related.
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?
The description explicitly mentions it is a paid tool costing $0.25 USDC per call, which informs usage considerations. However, it does not provide explicit when-to-use or when-not-to-use guidance compared to alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_data_api_catalogAInspect
List all 29 paid pay-per-call endpoints of JP Data API (x402/USDC): filings, FX, weather, anime, sports, prediction markets and more.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must cover behavioral traits. It correctly indicates a read-only listing operation but lacks details on output format, authentication, or rate limits. Adequate but not comprehensive.
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?
A single sentence with clear front-loading. Every word contributes meaning without redundancy.
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?
Given the low complexity (no parameters, no output schema), the description is mostly complete. It could mention the output format (e.g., JSON list) but is sufficient for tool selection.
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?
There are no parameters, and schema_description_coverage is 100%. The baseline for zero parameters is 4; the description adds no parameter info but none is needed.
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?
The description clearly states the action ('List') and resource ('all 29 paid pay-per-call endpoints of JP Data API'), with specific examples. This distinguishes it from sibling tools which target individual endpoints.
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?
The description implies usage for obtaining an overview of available paid endpoints. While it does not explicitly state when to avoid this tool or list alternatives, the context is simple and self-evident.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_filings_listCInspect
Daily Japanese corporate disclosures from EDINET (Japan FSA). PAID TOOL: costs $0.01 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | YYYY-MM-DD |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose all behavioral traits. It only adds the cost and payment method (x402), but does not mention data freshness, pagination, or any side effects like rate limits.
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?
Two sentences: first states purpose, second states cost. It is front-loaded and concise, with no wasted words.
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?
Given a simple tool with one parameter and no output schema, the description is minimally adequate. However, it lacks details on return format, pagination, or scope of filings (e.g., does it return all filings for the day?).
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?
The schema already describes the 'date' parameter as YYYY-MM-DD, so the description adds no extra meaning. Since coverage is 100%, baseline is 3.
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?
The description clearly states the tool retrieves daily Japanese corporate disclosures from EDINET, which aligns with the tool name. However, it does not differentiate from sibling tools like jp_company_brief, which could cause confusion.
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?
The only guideline is the cost ($0.01 per call). No information is given about when to use this tool vs. alternative tools, nor any prerequisites or filters.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_memory_getCInspect
Retrieve a value from persistent agent memory. PAID TOOL: costs $0.001 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| ns | Yes | ||
| key | Yes |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must disclose behavioral traits. It mentions cost, but not that it's read-only, what happens if the key is missing, or any required permissions.
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?
Two sentences, minimal waste; however, the brevity sacrifices necessary parameter explanation.
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?
The description omits parameter details, return value info, and behavioral context beyond cost, making it incomplete for effective tool selection.
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 0%, and the description does not explain the 'ns' and 'key' parameters at all, leaving them completely opaque.
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?
The description clearly states the action ('Retrieve a value') and the resource ('persistent agent memory'), and it distinguishes from the sibling tool jp_memory_set, which sets values.
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?
No guidance on when to use this tool versus alternatives; only mentions it is a paid tool, but lacks explicit context for usage or exclusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_memory_setCInspect
Store a value in persistent agent memory that survives across sessions. PAID TOOL: costs $0.002 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| ns | Yes | ||
| key | Yes | ||
| value | Yes |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It states persistence across sessions but does not disclose key behaviors such as whether values are overwritten, if there are size limits, or any authorization requirements. The cost is mentioned but that is a pricing detail, not a behavioral trait.
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?
The description is very short (two sentences), no redundant information. The structure is clear: first sentence states purpose, second states cost. However, the extreme brevity sacrifices important details, making it less helpful than it could be.
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?
For a tool with three required string parameters and no output schema, the description is too minimal. It does not explain the role of each parameter, potential error conditions, or behavior upon reuse of the same key. Given the lack of annotations and output schema, more context is needed.
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 description coverage is 0% for the three parameters (ns, key, value). The description does not explain what 'ns' (namespace) means, what constraints apply to key and value, or how they should be formatted. No compensation is made for the missing schema documentation.
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?
The description uses a specific verb 'Store' and resource 'persistent agent memory', clearly indicating the action of remembering a value across sessions. It implicitly distinguishes from the sibling tool 'jp_memory_get' (retrieve vs store). However, it lacks detail about the key-value nature and namespace parameter.
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?
No guidance on when to use or when not to use this tool. There is no mention of alternatives, prerequisites, or limitations. The only extra note is about cost, which does not help in choosing this over alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_summarizeBInspect
Summarize any text into a concise English brief. PAID TOOL: costs $0.02 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| style | No | bullets | paragraph |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description discloses cost but fails to mention privacy, input language support, or output structure beyond 'concise English brief'. More behavioral detail needed.
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?
Two sentences, no filler. Purpose and cost communicated efficiently with front-loaded information.
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?
No output schema; description only says 'concise English brief' without specifying structure. Missing details on input length limits and language. Incomplete for a text processing tool.
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 50% (style has description, text does not). Description adds no detail on text format or style values, leaving agent guessing about expected inputs.
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?
Description clearly states the tool summarizes any text into a concise English brief, specifying verb and resource. It distinguishes from Japan-specific sibling tools.
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?
Mentions cost ($0.02 per call) which implies careful use, but no explicit when-to-use or when-not-to-use guidance. No alternatives listed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
jp_translateAInspect
Japanese-English translation (both directions), natural context-aware output. PAID TOOL: costs $0.02 USDC per call via x402.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | en | ja (optional) | |
| text | Yes |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses that the tool is paid ($0.02/call) and mentions 'natural context-aware output' as a quality trait. Does not discuss rate limits or other behavioral traits, but cost disclosure is valuable.
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?
Single sentence plus cost note. No wasted words. Front-loaded with purpose and direction. Highly efficient.
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?
For a simple translation tool, the description combined with schema provides sufficient context. Cost and quality are covered. However, missing guidance on default direction when 'to' is omitted and no output schema description, but output is self-evident.
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 50% (text param missing description, to param described). Tool description adds the context of bidirectional translation and cost, but does not elaborate on parameter usage (e.g., what happens if 'to' is omitted). Falls short of compensating for low schema coverage.
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?
Description clearly states it does Japanese-English translation in both directions with natural context-aware output. The verb 'translate' and resource 'Japanese-English' are specific. No ambiguity.
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?
Description implies usage for translation but does not specify when to use vs alternatives. No sibling translation tools, but guidance on limitations (e.g., length, domain) is missing. Context is clear but no when-not-to-use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
world_city_guideCInspect
Travel guide for world major cities: attractions, food, transit.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No |
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full burden. It does not disclose data source, update frequency, scope (e.g., which cities exactly), or any limitations. Beyond stating content categories, it offers little behavioral context.
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?
The description is very concise (one sentence) and front-loaded with the purpose. However, it is too brief to be helpful, sacrificing necessary detail for brevity.
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 no output schema, the description should detail return format and structure. It lists general categories but omits specifics like whether results are text, structured data, or links. The parameter documentation is also lacking, making the description incomplete.
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 0%, meaning the description must explain the 'city' parameter. It only mentions 'world major cities', lacking precise guidance on expected values, format, or case sensitivity. This is insufficient for correct invocation.
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?
The description clearly states it is a travel guide for world major cities covering attractions, food, and transit. It implicitly distinguishes from Japan-specific siblings, though a more active verb like 'Get' would improve clarity.
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?
No explicit guidance on when to use this tool. However, the sibling tools are all Japan-focused, so it is implied that this tool is for cities outside Japan or globally. No when-not-to-use or alternatives given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!