Skip to main content
Glama

Server Details

Booking decisions, scorecards, and self-checks for Florida food vendors over live DBPR data.

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.

MCP client
Glama
MCP server

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.

100% free. Your data is private.
Tool DescriptionsA

Average 4.2/5 across 12 of 12 tools scored. Lowest: 3.6/5.

Server CoherenceA
Disambiguation4/5

Most tools have distinct purposes, but the aliases 'fetch' and 'search' duplicate get_scorecard and search_vendors, introducing minor ambiguity. Also, decide_vendor and improve_my_score both deal with scorecards but for different users, which could cause confusion.

Naming Consistency3/5

Most tools follow a verb_noun snake_case pattern, but 'fetch' and 'search' are simple verbs breaking the pattern. Also, 'improve_my_score' uses a first-person pronoun, differing from others. This inconsistency is noticeable but not chaotic.

Tool Count5/5

12 tools are well-scoped for the domain of Florida food vendor compliance and event management. Each tool serves a clear purpose, and the count is neither too few nor too many.

Completeness4/5

The tool set covers key workflows: vendor search, scorecard retrieval, event lookup, decision support, checklists, and signup. However, it lacks direct booking functionality (decide_vendor returns a decision but doesn't execute booking), which is a minor gap for an organizer's end-to-end workflow.

Available Tools

12 tools
decide_vendorAInspect

One-call booking decision for a Florida food vendor: CLEAR, CONDITIONAL, REVIEW, or DECLINE with reason codes, the evidence behind it, the documents to collect for the event type, and a signed receipt the organizer can keep in their compliance file. This is the recommended vetting tool; use search_vendors first only when you do not have a license number.

ParametersJSON Schema
NameRequiredDescriptionDefault
vendor_idNoVendor id (UUID) from search_vendors
event_typeNoEvent type the document list is tailored to (default food-truck-night)
license_numberNoFlorida DBPR license number, with or without the letter prefix
Behavior2/5

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

No annotations are provided, so the description must disclose behavioral traits. It alludes to creating a signed receipt (indicating a write operation) but does not explicitly state whether this tool mutates data, what permissions are needed, or if the decision is reversible. This is insufficient for a mutation tool description.

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 very concise with two sentences, no filler, and front-loaded with the tool's primary function. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description communicates the tool's purpose and key outputs (decision, reason, evidence, documents, receipt) but lacks details on output structure or exactly what 'evidence' and 'reason codes' look like. Adequate but not comprehensive.

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 baseline is 3. The description adds context about license_number vs vendor_id and mentions event_type relevance to document collection, but does not elaborate on parameter formats or constraints beyond the schema. No significant added value.

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?

The description clearly states the tool makes a booking decision for a Florida food vendor with specific outcomes (CLEAR, CONDITIONAL, REVIEW, DECLINE) and includes detailed outputs (reason codes, evidence, documents, receipt). It also distinguishes itself by recommending search_vendors for when no license number is available.

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

Usage Guidelines5/5

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

The description explicitly says this is the recommended vetting tool and directs agents to use search_vendors first only when lacking a license number, providing clear when-to-use and when-not-to-use guidance.

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

fetchAInspect

Alias of get_scorecard for ChatGPT Deep Research connectors. Takes a vendor id from search and returns the full public scorecard as a document (id, title, text, url, metadata).

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesVendor id (UUID) from search
Behavior3/5

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

With no annotations, the description carries the full burden for behavioral transparency. It accurately describes the return format as a document with id, title, text, url, metadata. However, it does not disclose potential side effects, authentication requirements, or error handling, which is a gap for a read-only operation.

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?

The description is a single, concise sentence that efficiently conveys the tool's purpose and return format. While it could be slightly restructured for clarity, there is no unnecessary verbosity.

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?

For a simple fetch tool, the description covers the key aspects: the input requirement (vendor id from search) and the output structure (document with listed fields). However, it lacks details on error handling or edge cases, but given no output schema, it provides adequate context for a basic tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for the 'id' parameter. The description adds value by specifying that the id comes 'from search', implying it's a UUID from search results. This provides context beyond the schema's basic description.

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 clearly states that 'fetch' is an alias of 'get_scorecard' and returns the full public scorecard as a document with specified fields. The verb 'fetch' and resource 'scorecard' are specific, though it doesn't explicitly differentiate from 'get_scorecard' beyond noting it's for ChatGPT Deep Research connectors.

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?

The description mentions that the tool takes a vendor id from search, implying a prerequisite of having searched first. However, it does not provide explicit guidance on when to use this alias versus the sibling 'get_scorecard' tool, nor does it state 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.

get_checklistAInspect

A Florida organizer checklist as markdown. Slugs: florida-food-truck-night (breweries, HOAs, churches), festival-food-vendors (festivals, farmers markets), city-special-event-food-vendors (public property).

ParametersJSON Schema
NameRequiredDescriptionDefault
slugYes
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It discloses the output format (markdown) and the parameter values, but does not mention whether the tool is read-only, any authorization requirements, or performance characteristics. The behavioral transparency is 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.

Conciseness5/5

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

The description is extremely concise: two sentences that immediately state the tool's purpose and then list the slug options with their contexts. Every word serves a purpose, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one enum parameter and no nested objects or output schema, the description provides complete context: what the tool does, how to use it (the slug options), and what to expect (markdown output). No additional information is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although schema coverage is 0% (the description does not separately describe the parameter), the description fully explains the meaning of each enum value by listing the associated context (e.g., 'breweries, HOAs, churches' for 'florida-food-truck-night'). This adds significant semantic value beyond the raw enum names in 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?

The description clearly states the tool returns a 'Florida organizer checklist as markdown' and lists the specific slugs with their contexts. The verb is implied (retrieves) and the resource is a specific checklist, differentiating it from sibling tools like 'get_event' or 'get_platform_info'.

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?

The description provides contextual usage guidance by mapping each slug to its associated venues (e.g., 'florida-food-truck-night' for breweries, HOAs, churches). While it doesn't explicitly state when not to use or name alternatives, the context is clear enough for an agent to select the appropriate slug based on the scenario.

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

get_eventAInspect

One published event's public details: dates, venue, city, application deadline, required documents, and the apply link. Use the slug from list_open_events or from a venumark.com/event/ URL.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugYesEvent slug from list_open_events or the event URL
Behavior4/5

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

With no annotations provided, the description carries the full burden. It accurately states that only public details are returned (dates, venue, etc.), implying a read-only operation. It does not mention authentication, rate limits, or potential errors, but the behavioral trait is clear.

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 extremely concise, consisting of two sentences with no superfluous words. The first sentence front-loads the tool's purpose and returned fields, and the second provides usage guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema, no nested objects), the description covers all necessary information: what it does, what it returns, and how to obtain the input. It is complete for an agent to select and invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the parameter 'slug' is already documented. The description adds value by specifying where to obtain the slug (list_open_events or URL), providing context 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?

The description clearly states the tool retrieves public details of one published event, listing specific fields. It distinguishes from siblings like list_open_events (which lists events) and get_signup_link (which provides a signup link) by specifying the scope and data returned.

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?

The description provides explicit context on when to use the tool: after obtaining a slug from list_open_events or from a URL. It gives a clear alternative source for the slug but does not mention when not to use this tool or provide other exclusion criteria.

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

get_platform_infoAInspect

What VenuMark is (the food vendor application and compliance platform for Florida events), how the workflow runs, current pricing tiers, and which tier fits an organizer. Use when someone asks about running vendor applications, pricing, or whether VenuMark fits their event.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior4/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It indicates that the tool is informational and returns platform details, implying no destructive side effects. However, it does not mention authentication requirements or data source, which would be helpful. The description is still fairly transparent about the non-mutating nature of the tool.

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 exceptionally concise, consisting of two sentences. The first sentence lists the information provided, and the second gives clear usage guidance. Every sentence adds value without redundancy, and the most critical information is front-loaded.

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?

The description adequately explains what the tool does and when to use it, covering the complexity of the tool (no parameters, no output schema). While it does not detail the output format, the listed topics (platform identity, workflow, pricing, tier fit) provide enough context for the agent to understand the return value.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the description does not need to elaborate on parameters. According to scoring guidelines, zero parameters warrants a baseline score of 4. The description adds no parameter information because none are needed.

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?

The description clearly states that the tool provides information about VenuMark's identity, workflow, pricing tiers, and tier fit. It uses the specific verb 'get' with the resource 'platform info' and distinguishes itself from sibling tools like 'get_event' or 'get_checklist' by focusing on the platform itself rather than specific events or entities.

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?

The description explicitly advises when to use the tool: when someone asks about running vendor applications, pricing, or whether VenuMark fits their event. While it does not explicitly state when not to use it, the usage context is clear and sufficient for the agent to make appropriate selections among siblings.

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

get_scorecardAInspect

One vendor's public compliance record: letter grade (or withheld when the current DBPR license cannot be confirmed), license status, inspection recency, and record shape. Look up by vendor_id from search_vendors, or directly by license_number (MFD3953067 or 3953067) to vet a vendor in one call. Grades: A to F, plus HOLD (active DBPR license hold), Ungraded (insufficient record), and Withheld (license unconfirmed).

ParametersJSON Schema
NameRequiredDescriptionDefault
vendor_idNoVendor id (UUID) from search_vendors
license_numberNoFlorida DBPR license number, with or without the letter prefix
Behavior4/5

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

No annotations exist, so description carries full burden. It explains the output components and grade meanings (A-F, HOLD, Ungraded, Withheld). It does not mention side effects or auth needs, but for a read-only lookup this is acceptable.

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?

Two sentences with no wasted words. Key information is front-loaded, followed by a clear explanation of grade values.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, but description thoroughly explains return values. Parameter count is low and all are optional. The description provides enough context for an agent to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions. The description adds value by explaining where vendor_id comes from and clarifying license_number format, which is 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?

The description clearly states it retrieves a vendor's public compliance record with specific fields (letter grade, license status, inspection recency, record shape). It distinguishes from siblings like search_vendors by focusing on a single vendor's compliance details.

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?

The description provides usage context: look up by vendor_id from search_vendors or directly by license_number. It explains the purpose is to vet a vendor in one call but does not explicitly state when not to use or mention alternatives.

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

improve_my_scoreAInspect

For a Florida food truck or caterer checking their own record: what is currently limiting the VMScore letter grade, what to do about each item, official Florida DBPR resources, and a link to claim the free VenuMark vendor profile. Look up by license_number (MFD3953067 and 3953067 both work) or vendor_id from search_vendors. Organizers vetting a vendor for booking should use decide_vendor instead. Grades: A to F, plus HOLD (active DBPR license hold), Ungraded (insufficient record), and Withheld (license unconfirmed).

ParametersJSON Schema
NameRequiredDescriptionDefault
vendor_idNoVendor id (UUID) from search_vendors
license_numberNoFlorida DBPR license number, with or without the letter prefix
Behavior4/5

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

Describes output (limiting factors, actions, resources, link) and grade categories. As no annotations exist, it carries full burden; it is clear about being a lookup tool with no side effects implied, though it does not explicitly state idempotency.

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?

Two sentences efficiently cover purpose, audience, usage, alternatives, and details. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool is simple with 0 required params, no output schema. Description covers all: purpose, target, lookup methods, grade system, and links to sibling. Fully adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and description adds meaning: explains license_number format variations (with/without prefix) and that vendor_id comes from search_vendors, enhancing schema info.

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?

The description specifies the tool is for Florida food truck/caterers checking their own VMScore, listing what limits it and what to do. It clearly distinguishes from sibling 'decide_vendor', which is for organizers vetting vendors.

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

Usage Guidelines5/5

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

Explicitly states target users and when not to use: 'Organizers vetting a vendor for booking should use decide_vendor instead.' Also provides lookup methods with examples.

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

list_open_eventsAInspect

Florida events currently published on VenuMark and taking food vendor applications. Optional city filter. Each result includes the application deadline, required documents, and the public apply_url where a vendor applies (free account).

ParametersJSON Schema
NameRequiredDescriptionDefault
cityNoOptional Florida city filter, e.g. TAMPA
Behavior3/5

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

Describes output fields (deadline, documents, apply_url) but does not declare read-only behavior or other side effects. With no annotations, the description carries the burden and is minimally adequate.

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?

Single sentence covering action, scope, filter, and output details. No extra words, but could be slightly more structured with bullet points for output fields.

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?

For a simple list tool with one optional parameter, the description explains the scope and result contents. Lacks pagination info but that is acceptable given the simplicity.

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% for the single parameter 'city', and the description adds essentially the same example as the schema. Baseline 3 is appropriate.

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?

Clearly states the tool lists Florida events from VenuMark that accept food vendor applications, with an optional city filter. This distinguishes it from siblings like get_event or search.

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?

Implies usage for finding open events accepting applications but does not explicitly state when to use or not use it, nor contrasts with alternatives like search.

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

search_vendorsAInspect

Search all licensed Florida food trucks and caterers (19,000+, scored from official DBPR inspection records). Matches business name, prior names, license number (MFD3953067 and 3953067 both work), and city. Optional county, grade, and limit filters. Grades: A to F, plus HOLD (active DBPR license hold), Ungraded (insufficient record), and Withheld (license unconfirmed). Returns matches with license status, letter grade, and a scorecard link.

ParametersJSON Schema
NameRequiredDescriptionDefault
cityNoOptional Florida city filter, e.g. TAMPA
gradeNoOptional: only vendors currently holding this grade
limitNoMax results, 1 to 25 (default 10)
queryNoBusiness name or license number (partial ok). Optional when city is given.
countyNoOptional Florida county filter, e.g. Hillsborough
Behavior4/5

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

With no annotations, the description carries full burden. It discloses the data source (19,000+ DBPR records), license number format examples, detailed grade definitions (including HOLD, Ungraded, Withheld), and the return fields (license status, grade, scorecard link). It does not mention rate limits or authentication but adequately describes behavioral traits for a search tool.

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?

The description is about 80 words, front-loaded with the main purpose, and lists key details efficiently. It is structured in a logical flow from general purpose to specific filters and returns. Slightly verbose with the grade list, but overall concise.

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?

Given no output schema, the description explains return fields (license status, grade, scorecard link) adequately. It covers all input parameters contextually, including license number flexibility and grade definitions. The tool is moderately complex with 5 optional parameters, and the description provides sufficient context without gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage, so baseline is 3. The description adds value by explaining license number formats (MFD and plain numeric), the optionality of query when city is given, and expanding on grade enum values (including Ungraded and Withheld not in the schema enum). This goes beyond the schema alone.

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?

The description clearly states it searches for licensed Florida food trucks and caterers from official DBPR records, specifying match fields like business name, prior names, license number formats, and city. It also lists optional filters and output fields, distinguishing it from generic sibling tools like 'search' and 'get_scorecard'.

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?

The description implies usage via its specificity but does not explicitly state when to use this tool versus alternatives (e.g., 'search' or 'get_scorecard'). No when-not-to-use guidance is provided, leaving the agent to infer from context.

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

submit_leadAInspect

Send an organizer's contact request to the VenuMark founder (setup help, demo, festival or city program, Enterprise scope). Only call after the user has explicitly confirmed the exact details to send. The founder replies by email, usually the same day.

ParametersJSON Schema
NameRequiredDescriptionDefault
cityNoFlorida city or region (optional)
nameYesThe person's name
emailYesWhere the founder should reply
messageNoWhat they need help with (optional)
event_typeNoe.g. brewery food truck night, festival, farmers market, city event
organizationNoBusiness, venue, or city (optional)
Behavior3/5

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

No annotations provided. The description adds behavioral context (founder replies by email same day) but does not disclose potential side effects, error handling, or rate limits. Adequate but not rich.

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?

Two sentences, front-loaded with purpose, no wasted words. Efficient and well-structured.

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?

Given no output schema, the description explains the outcome (founder replies). Handles the submission scenario well. Could mention required fields explicitly, but overall complete.

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% (all 6 parameters have descriptions). The tool description does not add parameter details beyond what the schema provides, so baseline 3 is appropriate.

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 clearly states the tool sends a contact request to the VenuMark founder for setup help, demos, etc. It distinguishes from sibling tools (e.g., fetch, search) by its submission action, though no explicit comparison is made.

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 states 'Only call after the user has explicitly confirmed the exact details to send,' providing a clear precondition. Also mentions the founder replies by email, but lacks when-not-to-use or alternative tool guidance.

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

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources