Skip to main content
Glama

Coinlight: pay-per-call crypto data for agents (x402)

Crypto unit converter

units_convert
Read-only

Exact, bigint-safe conversion between human and atomic units: SOL<->lamports, ETH<->gwei<->wei, USDC<->atomic (6 decimals) or any decimals. ($0.005 USDC per call via x402 at https://coinlight-app.vercel.app/p/units-convert)

Input Schema

NameRequiredDescriptionDefault
fromYesUnit of amount.
amountYesAmount to convert, e.g. 1.5
paymentNoOptional x402 PAYMENT-SIGNATURE header value. Omit to use a free trial call or get payment requirements.
decimalsNoDecimals when from is units/atomic. Default 6.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Beyond the readOnlyHint/openWorldHint annotations, the description discloses two genuinely useful traits: results are exact and bigint-safe (no float precision loss), and each call costs $0.005 USDC via x402 at a specific endpoint. It does not explain rounding or behavior when from equals the target unit, so it stops short of a 5.

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, both earning their place: the conversion scope and precision guarantee come first, the pricing/endpoint detail second. No filler and no repetition of the title.

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?

There is no output schema, yet the description never states what a successful result looks like (a string? the converted amount plus unit?) or how payment failures surface. Annotations and 100% schema coverage handle the safety and input side, so the remaining gap is the return contract, which matters for a converter an agent must chain into further arithmetic.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents amount, from, payment, and decimals, giving a baseline of 3. The description adds some meaning by tying 'usdc' to 6 decimals and covering the generic units/atomic case with arbitrary decimals, but it does not clarify the payment-signature flow beyond what the schema says.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('conversion') and resource (human vs atomic units) and enumerates the exact currency pairs supported (SOL<->lamports, ETH<->gwei<->wei, USDC<->atomic). This lets an agent distinguish it from the similar-sounding sibling time_convert without opening either schema.

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

Usage Guidelines4/5

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

The enumerated pair list makes the applicable domain clear and implicitly excludes time_convert. However, there is no explicit 'when not to use' statement or a named alternative for edge cases such as passing identical from/to units.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources