Skip to main content
Glama

Will this MCP call succeed? (7Maps)

preflight
Read-onlyIdempotent

Use this right before calling a tool on an MCP server you have not used today, with the exact arguments you plan to send: checks that the server answers, whether it needs sign-in, that the tool still exists under that name, and that the arguments match the tool's input schema (required, types, allowed values, unknown keys). Returns go, no_go or fix with what to change (sign_in_first, with how to connect, for a server behind sign-in), so a failed round trip and retry are avoided. Paid per check (see list_paid_tools). Never calls the server.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "server": "<server>",
      "tool": "<tool>"
    },
    "name": "preflight"
  }
}

Input Schema

NameRequiredDescriptionDefault
toolYesThe tool you plan to call
serverYesThe server URL or its official registry name
argumentsNoThe arguments you plan to send
last_tripNoOptional: how your previous call to a server 7Maps named went
license_keyNo7IT plan license key; else pay per call (x402)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / last_trip / description
      Previous value: -"Optional: how your previous call to an MCP server went (one 7Maps named), as the last 7Maps answer shows."New value: +"Optional: how your previous call to a server 7Maps named went"
    • changedInput schema / properties / last_trip / properties / charged_usd / description
      Previous value: -"What the server charged, if anything"New value: +"Charged in USD"
    • changedInput schema / properties / last_trip / properties / fail / description
      Previous value: -"If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result"New value: +"Why it failed"
    • changedInput schema / properties / last_trip / properties / matched_description / description
      Previous value: -"Whether the result matched what the tool description promised"New value: +"Result matched the tool description"
    • changedInput schema / properties / last_trip / properties / ms / description
      Previous value: -"How long the call took, in milliseconds"New value: +"Duration in ms"
    • changedInput schema / properties / last_trip / properties / ok / description
      Previous value: -"Whether the call did what you needed"New value: +"Did it do what you needed"
    • changedInput schema / properties / last_trip / properties / result_tokens / description
      Previous value: -"About how many tokens the result was"New value: +"Result size in tokens"
    • changedInput schema / properties / last_trip / properties / server / description
      Previous value: -"The MCP server you called (URL or registry name)"New value: +"Server called (URL or registry name)"
    • changedInput schema / properties / last_trip / properties / surprise / description
      Previous value: -"Anything the tool did that you did not ask for"New value: +"Side effect you did not ask for"
    • changedInput schema / properties / last_trip / properties / tool / description
      Previous value: -"The tool you called"New value: +"Tool called"
    • changedInput schema / properties / last_trip / properties / tools_hash / description
      Previous value: -"The tool_list_hash of the tool list you received, if you computed it as 7Maps does"New value: +"tool_list_hash, computed as 7Maps does"
    • changedInput schema / properties / license_key / description
      Previous value: -"A 7IT monthly plan license key, if you have one; otherwise pay per call with x402"New value: +"7IT plan license key; else pay per call (x402)"
  2. Changed1 schema field changed
    • changedInput schema / properties / last_trip / description
      Previous value: -"Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge."New value: +"Optional: how your previous call to an MCP server went (one 7Maps named), as the last 7Maps answer shows."
  3. Changed1 schema field changed
    • changedInput schema / properties / last_trip / description
      Previous value: -"Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; 5 accepted reports from a paying wallet earn 1 call at no charge."New value: +"Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge."
  4. Changed1 schema field changed
    • changedInput schema / properties / last_trip / description
      Previous value: -"Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; 5 accepted reports from a paying wallet earn 1 free call."New value: +"Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; 5 accepted reports from a paying wallet earn 1 call at no charge."
  5. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already establish readOnly/idempotent/non-destructive, so the description's marginal contribution is the outcome model: it returns go, no_go or fix with remediation such as sign_in_first, and it never contacts the target server. That is real behavioral context. The cost disclosure is only hinted at ('Paid per check (see list_paid_tools)'), with no amount or idempotency-of-billing detail.

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 usage trigger, then the checks, then the return values, then cost and the no-call guarantee. Dense but every clause carries information; the parenthetical '(see list_paid_tools)' is a useful pointer rather than 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?

Covers purpose, timing, result vocabulary, remediation path, cost model, and the safety guarantee — enough to call it correctly despite five parameters including a nested object. The one visible gap is that last_trip, a structured report about a prior call, is never mentioned, so an agent has no stated reason to supply it.

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 description coverage is 100%, so the parameters are already documented, and the description adds only that the arguments should be the exact ones you plan to send. The optional last_trip feedback object and its enums (fail, surprise, tools_hash) are not explained at all in the description, so it neither adds nor compensates.

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 concrete verb and resource ('preflight ... checks that the server answers, whether it needs sign-in, that the tool still exists ... and that the arguments match the tool's input schema'), and distinguishes itself from actually invoking the remote tool with 'Never calls the server.' An agent can tell this apart from call-executing or discovery siblings without opening the schema.

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?

Gives an explicit trigger ('right before calling a tool on an MCP server you have not used today, with the exact arguments you plan to send') and a rationale (avoiding a failed round trip and retry). It does not name an alternative sibling or state the inverse case (skip when the server was already used today), but the timing condition is unambiguous enough to act on.

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