Skip to main content
Glama
CerebroChain

cerebrochain-mcp-server

by CerebroChain

@cerebrochain/mcp-server

npm version license Glama Score

The first logistics/WMS MCP server for AI agents. Connect Claude, Cursor, or any MCP-compatible AI to CerebroChain's supply chain APIs.

Installation

npm install -g @cerebrochain/mcp-server

Related MCP server: ShippingRates

Configuration

Claude Desktop

Add to ~/.config/claude-desktop/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "cerebrochain": {
      "command": "cerebrochain-mcp",
      "env": {
        "CEREBROCHAIN_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "cerebrochain": {
      "command": "cerebrochain-mcp",
      "env": {
        "CEREBROCHAIN_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Variable

Required

Description

CEREBROCHAIN_API_KEY

For Tier 2/3

Your CerebroChain API key

CEREBROCHAIN_API_URL

No

Custom API URL (default: https://cerebrochain.com/api)

CEREBROCHAIN_JWT_TOKEN

No

Alternative auth via JWT token

Available Tools

Tier 1 — Free (No API Key)

Tool

Description

compare_shipping_rates

Compare rates across UPS, FedEx, USPS, DHL

get_platform_status

Check platform health

Tier 2 — Authenticated (API Key Required)

Tool

Description

search_inventory

Search inventory items with filters

check_stock_levels

Get stock levels for an item

lookup_sku

Look up item by SKU

get_warehouse_locations

List warehouse storage locations

list_orders

List and search orders

get_order_status

Get order details and tracking

get_order_statistics

Get order KPIs

get_fleet_stats

Get fleet utilization metrics

list_vehicles

List fleet vehicles

track_shipment

Track a shipment route

list_shipments

Get shipment history

Tier 3 — Premium (Subscription Required)

Tool

Description

optimize_route

AI-powered route optimization

forecast_demand

AI demand forecasting

detect_bottlenecks

AI bottleneck detection

get_optimization_recommendations

AI optimization suggestions

get_financial_metrics

Revenue, margins, cash flow

get_kpi_dashboard

KPI targets vs actuals

natural_language_command

Natural language commands

Resources

URI

Description

cerebrochain://inventory/summary

Inventory overview

cerebrochain://logistics/fleet-status

Fleet status snapshot

cerebrochain://executive/kpi-snapshot

Executive KPIs

Example Usage

Once configured, ask your AI:

  • "Compare shipping rates from 90210 to 10001 for a 5lb package"

  • "Search inventory for items containing 'widget'"

  • "What's the status of order ORD-12345?"

  • "Optimize delivery route for these 10 stops"

  • "What items will be out of stock in 30 days?"

Get an API Key

Visit cerebrochain.com to create an account and generate an API key.

License

MIT

Available Tools

20 tools
check_stock_levelsA

Get current stock levels for a specific inventory item by ID. Returns quantity on hand, reserved, available. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
item_idYesInventory item ID

TDQS

A3.6/5.0
Behavior3/5

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

No annotations provided. Description discloses auth requirement and return fields but does not explicitly state read-only nature or potential side effects. Adequate for a simple read tool but could be more thorough.

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 concise sentences with front-loaded purpose. No unnecessary words.

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?

Sufficient for a simple tool with 1 parameter and no output schema. Could mention limitations like warehouse scope, but overall complete for its complexity.

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?

Only one parameter 'item_id' with schema description 'Inventory item ID'. Schema coverage is 100% so baseline 3; description adds no extra semantics beyond 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?

Description clearly states 'Get current stock levels for a specific inventory item by ID' and lists returned fields. Differentiates from siblings like 'search_inventory' and 'lookup_sku'.

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

Usage Guidelines2/5

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

No guidance on when to use this tool vs alternatives. Mentions API key requirement but no conditions or exclusions.

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

compare_shipping_ratesA

Compare shipping rates across multiple carriers (UPS, FedEx, USPS, DHL) for a package. Returns cheapest and fastest options. Free — no API key needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
from_zipYesOrigin ZIP/postal code
to_zipYesDestination ZIP/postal code
weight_lbsYesPackage weight in pounds
length_inNoPackage length in inches
width_inNoPackage width in inches
height_inNoPackage height in inches
from_countryNoOrigin country codeUS
to_countryNoDestination country codeUS

TDQS

A3.5/5.0
Behavior3/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 tool is free and requires no API key, but does not mention rate limits, precision of rates, or whether dimensions are needed for accurate comparisons. Behavioral traits are partially covered.

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, no filler. The first sentence delivers the core purpose with carrier names, the second adds a key selling point (free, no API key). Highly efficient and front-loaded.

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?

No output schema is provided, so the description should hint at return format. It says 'returns cheapest and fastest options' but does not explain structure (e.g., object with carrier, price, time). Also does not clarify if dimensions are mandatory for accurate rates, though schema marks them optional.

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%, so baseline is 3. The description does not add extra meaning to parameters beyond what the schema provides; it only mentions carriers which are not reflected in parameters.

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 compares shipping rates across multiple named carriers (UPS, FedEx, USPS, DHL) and returns cheapest and fastest options. This distinctly separates it from sibling tools like track_shipment or list_shipments.

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

Usage Guidelines2/5

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 versus alternatives among siblings, such as track_shipment for tracking or get_order_status for order details. The mention of 'Free — no API key needed' is a condition but not a comparative guideline.

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

detect_bottlenecksB

AI-powered bottleneck detection. Identifies current and predicted supply chain bottlenecks with severity and recommendations. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
scopeNoAnalysis scopefull-chain

TDQS

B3.4/5.0
Behavior2/5

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

No annotations are provided, so the description must carry the full burden. It notes the tool is 'AI-powered' and mentions premium status and API key requirement, but fails to disclose other behavioral traits like whether it is read-only, rate limits, or 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.

Conciseness4/5

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

The description is concise with two sentences, front-loading the core purpose. However, it could be slightly more structured to separate functional from non-functional aspects.

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 the tool has one optional parameter and no output schema, the description provides minimal context. It explains the basic purpose and premium nature, but lacks details about return format, data volume, or how to interpret results, which are important for an AI-powered tool.

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% for the single parameter 'scope'. The description adds no additional meaning beyond the schema's enum values and description 'Analysis scope'.

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 detects current and predicted supply chain bottlenecks with severity and recommendations. It provides a specific verb+resource combination and distinguishes from sibling tools like check_stock_levels and forecast_demand.

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 it is a premium tool requiring an API key, giving limited usage context. However, it lacks explicit guidance on when to use this tool versus alternatives 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.

forecast_demandC

AI-powered demand forecasting. Ask natural language questions about future inventory needs, sales trends, and supply chain patterns. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesNatural language forecast question (e.g., "What items will be out of stock in 30 days?")
hemisphereNoWhich hemisphere to querywms

TDQS

C2.9/5.0
Behavior2/5

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

No annotations provided, so description must convey all behavioral traits. It mentions 'AI-powered' and 'Requires API key' but omits details on response types, rate limits, latency, error handling, or whether it can handle multi-part questions. The description is insufficient for safe invocation.

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?

Three sentences, each adding distinct value: core function, capabilities, and constraints. No redundancy or wall of text. Efficiently front-loaded.

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

Completeness2/5

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

For an AI forecasting tool with no output schema, the description lacks details on return format (e.g., confidence intervals, time series data), error states, or prerequisites beyond API key. Incomplete for agent to gauge results.

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%, so baseline is 3. The description adds an example for query parameter, which is helpful. Hemisphere parameter is well-defined in schema. No further elaboration needed, but no extra value beyond schema.

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?

Description clearly states it forecasts demand using natural language questions, specifying target areas: inventory needs, sales trends, supply chain patterns. While it distinguishes from generic tools like natural_language_command, it could more explicitly contrast with siblings like detect_bottlenecks or get_optimization_recommendations.

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

Usage Guidelines2/5

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. The 'Premium tool. Requires API key.' hints at access but does not explain conditions or exclusions. Siblings suggest multiple ways to query data, but no comparative advice.

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

get_financial_metricsA

Get real-time financial metrics — revenue, margins, cash flow, profit/loss. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior4/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 indicates the tool is read-only ('Get real-time financial metrics') and discloses authentication requirements ('Requires API key'). However, it lacks details on rate limits, data freshness, or error handling.

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 concise sentences, front-loaded with the main action and key differentiators. No redundant information.

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 parameters and no output schema, the description is fairly complete. It explains the tool's function, sample data fields, and prerequisite. However, it does not mention output structure or potential overlap with sibling tools.

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 (100% schema coverage), so description does not need to explain parameters. It adds value by listing the data fields returned, which helps the agent understand output.

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 'Get real-time financial metrics' and lists specific examples (revenue, margins, cash flow, profit/loss). It distinguishes itself from sibling tools by focusing on financial data and mentioning 'Premium tool. Requires API key.'

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 the tool is premium and requires an API key, implying access control but does not explicitly state when to use it versus alternatives like get_kpi_dashboard. No guidance on when not to use is provided.

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

get_fleet_statsA

Get real-time fleet KPIs — active vehicles, utilization, fuel efficiency, maintenance status. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior2/5

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

No annotations are provided, so the description must fully disclose behavioral traits. It states 'real-time' and lists KPIs but does not specify whether the operation is read-only, idempotent, or if it has side effects. Additionally, there is no mention of rate limits, caching, or error behavior. For a real-time data retrieval tool, more transparency about data freshness and potential delays is needed.

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 two sentences long, starting with the core purpose 'Get real-time fleet KPIs', followed by a list of KPIs and authentication requirement. Every sentence adds value without redundancy. It is well-structured and efficiently conveys essential information.

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?

The tool has no parameters, no output schema, and no annotations, so the description is the sole source of information. While it covers purpose and authentication, it lacks details on the return format, data volume, update frequency, and whether the 'real-time' aspect imposes rate limits. For a KPI tool used for monitoring, more context about data staleness and pagination would improve completeness.

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 no parameters (100% coverage by description), so the baseline is 4. The description lists the specific KPIs returned (active vehicles, utilization, fuel efficiency, maintenance status), which adds context beyond the empty schema. No parameter documentation is needed, but the description could enhance clarity by noting that no parameters are required.

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 specifies the verb 'Get', the resource 'real-time fleet KPIs', and lists specific KPIs (active vehicles, utilization, fuel efficiency, maintenance status). The name 'get_fleet_stats' further reinforces purpose. Among sibling tools like 'list_vehicles' and 'get_kpi_dashboard', this tool is distinct for fleet-specific KPIs.

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 'Requires API key', which is an authentication requirement, but provides no explicit guidance on when to use this tool versus alternatives. It does not state when not to use it or offer comparisons to sibling tools like 'get_kpi_dashboard' or 'detect_bottlenecks', leaving the agent to infer usage context.

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

get_kpi_dashboardA

Get KPI performance dashboard — targets vs actuals for all key supply chain metrics. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. It mentions API key requirement but lacks details on read-only behavior, rate limits, or data refresh frequency. Does not disclose if the dashboard is aggregated or real-time.

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, no redundancy. First sentence immediately states purpose, second adds important access constraint. Every word contributes.

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?

With no parameters or output schema, description is minimal. It covers purpose and access but omits output format, interpretability, or integration hints with sibling tools. Adequate for a simple tool but could be more helpful.

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?

Zero parameters; schema coverage is 100%. Description adds value by explaining the dashboard content ('targets vs actuals for all key supply chain metrics') beyond the empty schema. Baseline score of 4 applies.

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?

Description uses specific verb 'Get' and resource 'KPI performance dashboard', clarifying scope as 'targets vs actuals for all key supply chain metrics'. It distinguishes from sibling tools like get_financial_metrics or get_optimization_recommendations.

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?

States 'Premium tool. Requires API key' as a constraint but does not explicitly say when to use this tool versus alternatives like check_stock_levels or get_order_statistics. Usage context is only implied.

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

get_optimization_recommendationsA

Get AI-generated optimization recommendations for warehouse operations, logistics routes, or overall supply chain efficiency. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
areaNoArea to optimizeoverall

TDQS

A3.6/5.0
Behavior2/5

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

No annotations are provided, so the description must fully disclose behavior. It only mentions 'AI-generated' without details on side effects, rate limits, or authentication requirements beyond an API key.

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 concise sentences that efficiently convey purpose and access requirements without redundancy.

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 the simple input (one optional enum) and no output schema, the description provides adequate context. Lacks details on response format but is otherwise sufficient.

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% with clear enum descriptions. The description adds general context but does not enhance parameter meaning beyond what the schema already provides.

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 retrieves AI-generated optimization recommendations for warehouse operations, logistics routes, or overall supply chain efficiency. Differentiates from sibling tools like optimize_route which is more specific.

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?

Mentions it's a premium tool requiring an API key, implying restricted usage, but does not explicitly compare to alternatives or state 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.

get_order_statisticsB

Get order statistics and KPIs — total orders, fulfillment rate, average value, trends. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

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

With no annotations, the description carries full burden. It mentions the auth requirement (API key) but omits other behavioral traits like data staleness, read-only nature, or rate limits. The coverage is minimal.

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?

Two sentences, each adding value. Could be more concise but no wasted words. Structure is front-loaded with purpose.

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?

No output schema exists, so description must explain returns. It lists the key outputs (total orders, fulfillment rate, average value, trends). Though format details are missing, it covers the main semantics. For a parameterless tool, this is fairly complete.

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?

No parameters exist, so schema coverage is irrelevant. The description adds no parameter info but none is needed. Baseline 4 applies as no value is lost.

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 retrieves order statistics and KPIs, listing specific metrics. It is unambiguous but does not explicitly differentiate from siblings like get_kpi_dashboard. Score 4 for clear purpose with minor lack of distinction.

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

Usage Guidelines2/5

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

The only usage guidance is 'Requires API key'. There is no advice on when to use this tool versus alternatives (e.g., get_kpi_dashboard, get_financial_metrics). The agent receives no context for selection decisions.

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

get_order_statusB

Get detailed status and tracking for a specific order. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
order_idYesOrder ID to look up

TDQS

B3.2/5.0
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 only mentions the requirement for an API key, but omits details like rate limits, error handling, 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.

Conciseness4/5

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

Two sentences, front-loaded with the main purpose, and a succinct auth note. Could be slightly more concise but generally well-structured.

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?

For a tool with one parameter and no output schema, the description covers basic purpose and auth but lacks detail on behavior (e.g., idempotency, data freshness, error responses) that would aid an AI agent.

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% with a single parameter, and the description does not add significant meaning beyond the schema's minimal description. Baseline score of 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?

The description clearly states the verb 'Get' and the resource 'detailed status and tracking for a specific order,' which distinguishes it from sibling tools like 'list_orders' or 'track_shipment'.

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

Usage Guidelines2/5

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 (e.g., track_shipment, get_order_statistics), nor when not to use it. The description lacks context for decision-making.

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

get_platform_statusA

Check CerebroChain platform health and service availability. Free — no API key needed.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

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

With no annotations provided, the description must carry the full burden of behavioral disclosure. It reveals that the tool is free and requires no API key, which is useful. However, it does not mention other traits like rate limits, data freshness, or whether it is read-only, leaving some behavioral aspects unspecified.

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 only two sentences that deliver essential information without any wasted words. It is front-loaded with the purpose and followed by a key usage note.

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 the tool's simplicity (0 parameters, no output schema), the description is reasonably complete. It covers what the tool does and a critical usage detail (free, no auth). However, it could be slightly more complete by mentioning what the health check returns (e.g., status indicators), but this is minor.

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 tool has 0 parameters and the schema coverage is 100% (empty schema). According to the guidelines, this gives a baseline of 4, as no parameter details are needed beyond what the schema provides.

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 verb 'Check' and the resource 'CerebroChain platform health and service availability', making the tool's purpose unambiguous. It also distinguishes from siblings by focusing on platform health, which no other sibling tool addresses.

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 notes 'Free — no API key needed', which provides clear guidance on when to use (no authentication required) and implies a cost-free check. However, it does not explicitly mention when not to use or list alternatives, though no obvious alternatives exist among siblings.

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

get_warehouse_locationsA

List warehouse storage locations with hierarchy (zones, aisles, bins). Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.6/5.0
Behavior3/5

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

With no annotations, the description carries the full burden. It states it's a read operation (list) and requires authentication. However, it does not disclose response structure, pagination, or any additional behavioral details beyond the basic operation. Adequate but minimal.

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 a single sentence that efficiently conveys the action, resource, and a key constraint (hierarchy detail) plus authentication requirement. No wasted words.

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 the tool has no parameters and no output schema, the description covers the essential purpose and a key security requirement. It is sufficiently complete for a simple list tool, though it could optionally mention default sorting or limits.

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?

There are no parameters, and schema description coverage is 100%. The description does not need to add parameter info, so 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?

The description clearly states it lists warehouse storage locations with hierarchy, specifying zones, aisles, and bins. The verb 'list' and resource 'warehouse locations' are precise, and the hierarchy detail distinguishes it from related tools like check_stock_levels or search_inventory.

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

Usage Guidelines2/5

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

The description only mentions a prerequisite (requires API key) but provides no guidance on when to use this tool versus alternatives, nor any exclusions or context for optimal use.

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

list_ordersA

List and search orders with filters. Returns order ID, status, items, total value. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
statusNoFilter by order status
pageNoPage number
limitNoOrders per page

TDQS

A3.5/5.0
Behavior3/5

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

With no annotations, the description should disclose behavioral traits. It mentions 'Requires API key' and return fields, but does not address pagination behavior, rate limits, or data freshness. Provides some but not comprehensive transparency.

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, then return info and requirement. No wasted words, efficient and clear.

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?

No output schema, so description must cover returns. It lists some fields (ID, status, items, total value) but lacks pagination details, total count, or error handling. Adequate but not fully complete for a listing tool.

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 no specific parameter details beyond the schema; 'with filters' is generic. No additional meaning for status, page, or limit.

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 verb 'List and search' and resource 'orders', and mentions filters. It distinguishes from siblings like get_order_status (single order) and get_order_statistics (aggregates).

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

Usage Guidelines2/5

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 siblings like get_order_status or get_order_statistics. The description only notes an API key requirement, not usage context or alternatives.

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

list_shipmentsA

Get shipment history with analytics — 90-day view of all shipments, delivery rates, carrier performance. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

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

No annotations provided, so description carries full burden. It discloses the 90-day time window and requirement of API key, but does not explicitly state read-only nature, lack of modification, pagination, or 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.

Conciseness5/5

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

Two sentences, no wasted words. First sentence clearly states purpose and scope, second adds requirement. Perfectly concise.

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?

No output schema, so description must compensate. It mentions content (delivery rates, carrier performance) but lacks details on fields, pagination, or data structure, leaving some uncertainty.

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 has 0 parameters with 100% coverage; baseline is 4. Description adds no param details but 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?

Clearly states 'Get shipment history with analytics' and specifies '90-day view of all shipments, delivery rates, carrier performance', which is specific and distinguishes from siblings like track_shipment.

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

Usage Guidelines2/5

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

Only mentions 'Requires API key' as a precondition. No guidance on when to use this tool versus alternatives like compare_shipping_rates or detect_bottlenecks, and no when-not-to-use conditions.

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

list_vehiclesB

List fleet vehicles with status, location, and capacity. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
statusNoFilter by vehicle status

TDQS

B3.3/5.0
Behavior2/5

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

With no annotations, the description must disclose behavioral traits. It only mentions that an API key is required but does not state whether the operation is read-only, whether there are rate limits, pagination behavior, or any side effects. This is insufficient for a tool with zero annotations.

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: a single sentence that conveys the purpose and a required authentication detail. Every word earns its place with no redundancy.

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?

The tool is simple (one optional parameter, no output schema), so the description covers the basics: what is listed and auth requirement. However, it lacks details about return format, pagination, data limits, or ordering, which are relevant even for a simple list tool.

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 'status', which is fully described in the schema with an enum. The description adds no extra meaning beyond what the schema already provides, which is the baseline for high coverage.

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 verb 'List' and the resource 'fleet vehicles', and mentions specific attributes (status, location, capacity). This distinguishes it from sibling tools like 'get_fleet_stats' which likely return aggregated data.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives (e.g., 'get_fleet_stats' or 'track_shipment'). It does not mention any prerequisites or exclusions, leaving the agent to infer usage from the tool name alone.

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

lookup_skuA

Look up an inventory item by its SKU code. Returns full item details including stock, location, and pricing. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
skuYesSKU code to look up

TDQS

A3.8/5.0
Behavior3/5

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

No annotations are provided, so the description carries the burden. It notes the API key requirement and return details (stock, location, pricing), but lacks info on side effects, rate limits, or error handling.

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 concise sentences front-load the purpose and return value, with no unnecessary words.

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 single-parameter tool with no output schema, the description covers purpose, return details, and a requirement. Could mention it's a read-only operation for completeness.

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% with a description for the sku parameter. The description adds minimal value beyond 'by its SKU code', so 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?

The description clearly states the tool looks up an inventory item by SKU, a specific verb and resource. It distinguishes from siblings like search_inventory which may have broader scope.

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 an API key requirement but provides no guidance on when to use this tool versus alternatives like search_inventory or check_stock_levels.

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

natural_language_commandB

Process a natural language command through CerebroChain AI Command Center. Supports queries like "show me all delayed shipments" or "reserve 50 units of SKU-1234". Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandYesNatural language command or query

TDQS

B3.4/5.0
Behavior2/5

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

No annotations are provided. The description notes it is a 'Premium tool' and 'Requires API key', but does not disclose whether the command is read-only, destructive, or has side effects. For a tool that executes arbitrary natural language commands, this is a significant gap in 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.

Conciseness4/5

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

The description is brief with three sentences, including a clear opening statement and two supplementary notes. It avoids unnecessary detail, though the 'Premium tool' line could be integrated more seamlessly.

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 the absence of an output schema and the tool's broad capability, the description should clarify what the tool returns (e.g., confirmation, data, error messages). It covers basic usage and requirements, but lacks completeness for an NL command executor.

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 schema describes the parameter 'command' as 'Natural language command or query', and the description adds concrete examples ('show me all delayed shipments', 'reserve 50 units of SKU-1234'), enriching the semantic understanding 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 the tool processes natural language commands via CerebroChain AI Command Center, with specific examples like 'show me all delayed shipments'. This distinguishes it from the many sibling tools that handle specific functions, making the purpose unambiguous.

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

Usage Guidelines2/5

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

The description provides no explicit guidance on when to use this tool versus siblings. While it implies broad applicability, it does not advise against using it for tasks better handled by specific tools, nor does it mention prerequisites or exclusion criteria.

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

optimize_routeB

AI-powered route optimization. Calculates optimal delivery route considering traffic, capacity, time windows, and fuel costs. Premium tool. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
stopsYesDelivery stops to optimize
vehicle_capacity_lbsNoVehicle weight capacity in pounds

TDQS

B3.2/5.0
Behavior2/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 states the tool is 'AI-powered' and 'calculates,' implying a read-only operation, but does not disclose side effects, idempotency, or whether it requires write permissions.

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 concise—three short sentences—and front-loaded with the core purpose. No redundant or unnecessary information.

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?

The description explains the tool's purpose and key factors, but lacks details on output format (e.g., what is returned) and does not mention constraints like minItems=2 on stops. Given no output schema, this is a gap.

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%, and the description adds meaning by linking the parameters to optimization factors (e.g., 'capacity' relates to vehicle_capacity_lbs, 'time windows' to stops' time_window fields). This goes beyond the schema alone.

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 calculates optimal delivery routes considering key factors (traffic, capacity, time windows, fuel costs). However, it does not explicitly differentiate from sibling tools like get_optimization_recommendations, which may overlap.

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

Usage Guidelines2/5

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. The description mentions 'Premium tool. Requires API key,' which hints at access restrictions but does not provide context on tool selection.

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

search_inventoryC

Search inventory items with filters. Returns SKU, name, quantity, location, category. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
searchNoSearch term (name, SKU, barcode)
categoryNoFilter by category
pageNoPage number
limitNoItems per page

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are present, so the description must cover behavioral traits. It mentions the API key requirement and lists return fields, but omits pagination behavior, search semantics (fuzzy/exact), error handling, and rate limits. This is minimal 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.

Conciseness5/5

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

The description is two efficient sentences with no fluff. The core purpose and return fields are front-loaded.

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

Completeness2/5

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

Given the tool has 4 parameters, no output schema, and no annotations, the description is incomplete. It does not explain pagination behavior, default sorting, or when to use this tool over siblings with overlapping functionality.

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 descriptions are already clear and cover 100% of parameters. The tool description adds no additional semantic value beyond stating 'with filters', which is already implied. 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 it searches inventory items with filters and lists return fields (SKU, name, quantity, location, category). However, it does not differentiate from similar sibling tools like 'lookup_sku', which likely offers a more specific search by SKU.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives like 'lookup_sku' or 'get_warehouse_locations'. It only mentions a prerequisite (API key) but lacks context on appropriate scenarios.

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

track_shipmentA

Get real-time tracking for a shipment route — current location, progress, ETA, stops completed. Requires API key.

ParametersJSON Schema
NameRequiredDescriptionDefault
route_idYesRoute or shipment ID to track

TDQS

A3.8/5.0
Behavior3/5

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

No annotations are provided, so the description must disclose behavior. It mentions real-time tracking and API key requirement but does not explicitly state that it is a read-only operation, nor any side effects or rate limits. It is adequate but not thorough.

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 two sentences long, front-loading the purpose and return values, and then the requirement. No unnecessary words.

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 adequately describes what the tool returns (location, progress, ETA, stops). It is fairly complete for a simple tracking tool with one parameter, though could explicitly state the output is a tracking object.

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% with a clear parameter description for route_id. The tool description does not add additional meaning beyond what the schema already provides, so baseline of 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?

The description clearly states the verb 'Get', the resource 'shipment route', and the specifics it returns ('current location, progress, ETA, stops completed'). This distinguishes it from sibling tools like get_order_status or list_shipments.

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 includes a prerequisite ('Requires API key') but does not provide guidance on when to use this tool versus alternatives like get_order_status. Usage context is implied but not explicit.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 20 tool updatesv1.0.0
    • First observedcheck_stock_levels
    • First observedcompare_shipping_rates
    • First observeddetect_bottlenecks
    • First observedforecast_demand
    • First observedget_financial_metrics
    • First observedget_fleet_stats
    • First observedget_kpi_dashboard
    • First observedget_optimization_recommendations
    • First observedget_order_statistics
    • First observedget_order_status
    • First observedget_platform_status
    • First observedget_warehouse_locations
    • First observedlist_orders
    • First observedlist_shipments
    • First observedlist_vehicles
    • First observedlookup_sku
    • First observednatural_language_command
    • First observedoptimize_route
    • First observedsearch_inventory
    • First observedtrack_shipment

TDQS

A3.5/5.0

Scored across 20 tools

Disambiguation3/5

Most tools have distinct purposes (e.g., check_stock_levels vs lookup_sku vs search_inventory target different access patterns), but the natural_language_command tool significantly overlaps with list_orders, list_shipments, search_inventory, and others, creating ambiguity about when to use specific structured tools versus the flexible NL interface.

Naming Consistency5/5

Excellent consistency throughout. All tools use snake_case with clear verb_noun patterns (get_, list_, check_, search_, optimize_, compare_). Verb usage is predictable: 'get' for specific items, 'list' for collections, 'search' for filtered queries.

Tool Count4/5

Twenty tools is slightly above the ideal range but reasonable given the domain complexity spanning inventory, orders, shipments, fleet, warehouse, and AI analytics. Each tool serves a distinct supply chain function without obvious redundancy.

Completeness4/5

Strong coverage across the supply chain lifecycle: inventory management, order tracking, shipment logistics, fleet optimization, and financial metrics. Minor gaps in explicit write/update operations (create_order, update_inventory), though natural_language_command appears to handle some mutations.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Ocean container shipping intelligence for AI agents — D\&D tariffs, freight rates, vessel schedules, port congestion, inland haulage across 6 major carriers. 24 MCP tools.
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    62 real-time data tools for AI agents via MCP. Finance, crypto, FMCSA, sanctions, courts, weather, vehicles, cybersecurity. One bearer token, one bill. Free tier available.
    MIT