Skip to main content
Glama

Get the DigitalPublic agent onboarding guide

dp_commercial_get_onboarding_guide
Read-onlyIdempotent

Return the goal-oriented sequence an agent should follow, including every mandatory human checkpoint and the handoff from DigitalPublic Commercial to DigitalPublic.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
localeNoes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
dataYes
errorYes
linksYes
versionYes
evidenceYes
nextActionYes

TDQS

A3.6/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, and the description's 'Return' is consistent with those. The description adds useful context about the guide's contents, such as mandatory human checkpoints and the handoff, but it does not address auth needs, side effects, or edge behavior. For a read-only guide with annotations covering the safety profile, this is adequate but not exceptional.

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 front-loaded sentence that names the verb, resource, and key distinguishing features without fluff. Every part earns its place, and it remains compact for what it conveys.

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 tool with zero required parameters, a safe read-only annotation profile, and an output schema, the description covers what matters: the nature of the returned sequence and the critical handoff/checkpoint content. Return-value details are already handled by the output schema. The missing when-to-use guidance is a usage-guidance concern, not a contextual completeness gap for this simple operation.

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

Parameters2/5

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

The only parameter, locale, is constrained by enum ['es','en'] and default 'es' in the schema, but the description provides no explanation of it. With schema description coverage at 0%, the description should compensate by noting that locale selects the guide's language, and it does not. Invocation is still feasible because there is one optional, fully constrained parameter, so this is below baseline but not broken.

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 states a specific verb and resource: it returns the goal-oriented onboarding sequence an agent should follow, and it names two concrete contents, mandatory human checkpoints and the handoff from DigitalPublic Commercial to DigitalPublic. This clearly distinguishes it from sibling get_* tools such as dp_commercial_get_capability_matrix or dp_commercial_get_checkout_readiness. The title is reinforced, not merely restated.

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 when-to-use or when-not-to-use guidance is provided. The description does not say when an agent should choose this tool over siblings, nor does it name any alternatives or exclusions. The intended usage is only implicit from the tool name and title.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.6/5.0
Disambiguation4/5

Most tools have a clear, distinct target, and overlapping trial/checkout/status tools are cross-referenced in their descriptions. A few pairs such as get_checkout_readiness versus get_checkout_status and legacy claim_credentials versus start_sandbox could still be misselected, but the descriptions generally resolve the boundaries.

Naming Consistency5/5

All 28 tools share the dp_commercial_ prefix and follow a consistent snake_case verb_noun pattern such as get_, list_, start_, compare_, and request_. There is no mixing of camelCase, inconsistent verbs, or unpredictable naming.

Tool Count2/5

At 28 tools, the server is above the 25-tool threshold and feels heavy even for a broad commercial platform. Several informational tools, such as checkout readiness versus checkout status and service status versus uptime history, could be consolidated without losing core capability.

Completeness4/5

The toolset covers the core commercial lifecycle well: discover needs, compare plans, assess fit, start trial/checkout, request proposals, check status, and review security/compliance profiles. Minor gaps exist around post-checkout subscription management or cancellation, but the described handoff to the DigitalPublic product covers most dead ends.

Resources