textokit-mcp
Summary: textokit-mcp is a pay-per-call MCP server (x402/USDC on Base) offering 17 tools for web reading, text utilities, translations, Argentine data, market data and dev utilities, plus free catalog/sample tools.
Free discovery:
textokit_catalog(routes, prices, network) andtextokit_sample(free sample output + input example for any route).Web reading:
textokit_web_readandtextokit_url_textconvert public pages to clean text or Markdown with a max-character cap.Text processing:
textokit_source_bounded_summary(summary with verified quotes) andtextokit_comparar_textos(literal text diff).Spanish (Rioplatense):
textokit_translate_estranslates any language to Argentine Spanish with tone options;textokit_cartas_ardrafts formal letters (reclamo, intimación, solicitud).Market data:
textokit_fx_rates(160 currencies),textokit_crypto_prices(CoinGecko),textokit_polymarket_markets(markets, positions, activity).Argentine data:
textokit_dolar_ar,textokit_bcra_indicadores,textokit_cuit_ar(CUIT/CUIL validation),textokit_direcciones_ar(Georef addresses),textokit_normativa_ar(Boletín Oficial search).Dev utilities:
textokit_dev_utils(hash, HMAC, JWT decode, UUID4, base64, URL parse, time zone conversion).x402 ecosystem:
textokit_x402_adoption(Bazaar stats) andtextokit_x402_ping(cheapest payment test).Deployment: use the remote Streamable HTTP endpoint (no install, no private key) or the local npx package with
TEXTOKIT_PRIVATE_KEYandTEXTOKIT_MAX_CENTSspending cap; paid calls cost 0.001–0.005 USDC.
Integrates with the Coinbase CDP facilitator to settle x402 USDC payments on Base, only charging successful paid tool calls after a successful response.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@textokit-mcptranslate this to Rioplatense Spanish: Let's grab coffee tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
textokit-mcp
MCP server for tienda.textokit.store: 17 pay-per-call tools settled with x402 in USDC on Base, plus a free catalog and free samples. Run by Automata, ERC-8004 agent 98748. Every settlement is public at https://tienda.textokit.store/receipts.json.
Tools
Free, no wallet needed:
textokit_catalog: routes, prices, network.textokit_sample: the free sample of any route (same schema as the paid output) and an input example.
Paid (0.001 to 0.005 USDC per call, charged to your own wallet):
textokit_web_read,textokit_url_text: public page to clean text or Markdown.textokit_source_bounded_summary: summary with quotes verified as substrings.textokit_translate_es,textokit_cartas_ar: Rioplatense Spanish text.textokit_fx_rates,textokit_crypto_prices,textokit_polymarket_markets: market data.textokit_dolar_ar,textokit_bcra_indicadores,textokit_cuit_ar,textokit_direcciones_ar,textokit_normativa_ar: Argentine data.textokit_dev_utils,textokit_comparar_textos,textokit_x402_adoption,textokit_x402_ping.
Related MCP server: agent-toolkit-mcp
Remote server (no install)
The same tools are served over MCP Streamable HTTP at https://tienda.textokit.store/mcp
(stateless JSON-RPC over POST; listed in the official MCP Registry as io.github.martinPisacreta/textokit-mcp).
Claude Code:
claude mcp add --transport http textokit https://tienda.textokit.store/mcpCursor, Windsurf and other clients that accept a URL:
{ "mcpServers": { "textokit": { "url": "https://tienda.textokit.store/mcp" } } }The remote server never receives a private key. Free tools (textokit_catalog, textokit_sample,
textokit_how_to_pay) work right away. A paid tool called without payment returns the x402 payment
requirements; sign them with your own wallet and call the tool again with payment_signature (the base64
x402 v2 payload). If you prefer the server to sign for you, use the local package below.
Setup (local package)
Add to your MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, ...):
{
"mcpServers": {
"textokit": {
"command": "npx",
"args": ["-y", "textokit-mcp"],
"env": {
"TEXTOKIT_PRIVATE_KEY": "0x<EVM private key with USDC on Base>",
"TEXTOKIT_MAX_CENTS": "1"
}
}
}
}TEXTOKIT_PRIVATE_KEY: optional. Without it only the free tools work; paid tools return an explanatory error. Use a dedicated low-balance wallet. The key is never logged.TEXTOKIT_MAX_CENTS: cap per call in US cents (default 1). Calls above it are refused before signing.TEXTOKIT_BASE_URL,TEXTOKIT_TIMEOUT_MS: optional overrides.
How payment works
The tool POSTs to the route and gets HTTP 402 with x402 v2 payment requirements.
The server signs an EIP-3009
transferWithAuthorizationfor the exact amount with your key.It retries with the
PAYMENT-SIGNATUREheader. The store settles through the Coinbase CDP facilitator only after a successful response; a failed handler is never charged.The result includes the transaction hash under
payment.
Need an MCP server for your own API?
The author builds custom MCP servers like this one for other products: tools mapped to your API, credentials kept out of the config file, human approval for actions that spend or publish, local (stdio) or remote (Streamable HTTP), optionally published to npm and the MCP registry. Fixed-price packages on Upwork: https://www.upwork.com/services/product/2113736906027325062
Node 20 or newer. MIT.
Available Tools
19 toolstextokit_bcra_indicadoresBInspect
Indicadores monetarios del BCRA. 0.002 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| desde | No | Optional serie-only start date, YYYY-MM-DD; must not exceed… | |
| hasta | No | Optional serie-only end date, YYYY-MM-DD. | |
| limit | No | Requested page size, 1–20; defaults to 5. | |
| query | No | Optional lista-only text filter within the received page;… | |
| offset | No | Requested page offset; defaults to 0. | |
| resource | Yes | lista returns variables; serie returns observations for one… | |
| idVariable | No | Required for serie; forbidden for lista. Positive BCRA… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It usefully discloses the paid nature, price, payment rail (x402 on Base), wallet requirement, and free-sample alternative, but it omits read-only semantics, rate limits, error behavior, and 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short, front-loaded with the domain, and has no filler. It could be slightly more structured by separating purpose from payment details, but it remains efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a seven-parameter, paid data-retrieval tool with no annotations and no output schema, the description is thin. It covers payment and free sampling but says nothing about the lista versus serie modes or what the indicator data looks like, leaving the agent to rely entirely on the schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all seven parameters, including the lista/serie enum and idVariable condition, are already documented in the schema. The description adds no parameter-specific meaning beyond that, which fits the baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific data domain, BCRA monetary indicators, which is clearer than a generic finance tool. It lacks an explicit action verb and does not directly distinguish itself from siblings such as textokit_dolar_ar or textokit_fx_rates.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It mentions a free sample via textokit_sample, but only as a pricing alternative. There is no guidance on when to use this tool versus related sibling tools, nor any prerequisites or exclusions beyond the payment note.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_cartas_arAInspect
Formal letter in Argentine Spanish. 0.005 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| tipo | No | Letter type: reclamo, intimacion or solicitud. Defaults to… | |
| asunto | Yes | Subject to include in the reference line of the letter | |
| hechos | Yes | Supplied facts for the body, ordered chronologically when… | |
| plazoDias | No | Optional requested response period in days, from 1 to 60.… | |
| remitente | Yes | Name or identification to include in the signature | |
| solicitud | Yes | Requested action and conditions supplied by the buyer | |
| lugarYFecha | Yes | Place and date supplied by the buyer | |
| destinatario | Yes | Recipient person or organization |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden, and it does disclose the critical behavior that isn't in structured data: 0.005 USDC per call via x402 on Base from the caller's wallet. It says nothing about what the call returns, output length/format, or whether an unpaid call fails versus prompts a payment flow.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with zero filler; the purpose is front-loaded and payment plus free-sample routing follow. Every clause carries information an agent can act on.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For an 8-parameter, 6-required generation tool with no annotations and no output schema, the description covers purpose and payment mechanics, which are the highest-risk unknowns. It omits any hint about the generated output's shape or size, a modest gap given the rich parameter schema says nothing about returns.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, including enum values and max lengths, so parameters are already fully documented. The description adds no meaning beyond the schema, which is the correct baseline for full coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific artifact ('Formal letter in Argentine Spanish'), which is more precise than the opaque tool name and distinguishes it from neighbors like textokit_translate_es or textokit_comparar_textos. It stops short of a verb ('generate/write'), but an agent can still infer this is a letter-generation tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It routes to textokit_sample for a free trial, which is a genuine alternative pointer, and the price implies a paid production path. However, there is no explicit statement of when to pick this versus the sample, nor any prerequisite or exclusion guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_catalogBInspect
List all store routes with price in USDC, network and summary. Free, no payment.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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 does disclose the important behavioral trait that the call is free and requires no payment, which is genuinely non-obvious in this x402-oriented tool family, but it says nothing about return shape, ordering, pagination, or whether the listing can change over time.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences with no filler, and the content an agent needs first is front-loaded. The only minor cost is that the compression produces the opaque phrase 'store routes'.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description must carry the whole load, and it partially does by naming the key returned attributes and the zero-cost behavior. It stops short of describing the response structure or clarifying what a 'route' is, which is the main thing an agent would still need to know.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters and the schema is empty, so there is nothing to disambiguate. The description instead characterizes the fields in the response (price, network, summary), which is the only semantics an agent needs to invoke it correctly.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The verb 'List' is clear and the returned fields (price in USDC, network, summary) are named, but the resource is called 'store routes', a compressed term that does not plainly say this is a catalog of purchasable API endpoints. An agent can guess the intent, especially paired with the name textokit_catalog, but the purpose is not stated in unambiguous language.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'Free, no payment' usefully signals that this call carries no x402 payment requirement, which matters given paid siblings like textokit_x402_ping and textokit_crypto_prices. However, it never says when to use it versus those siblings or that it is the natural discovery step before invoking a route, so the guidance is implied rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_comparar_textosCInspect
Compare texts literally. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| entrega | Yes | String to compare against the original; at most 20000 UTF-16… | |
| original | Yes | Original string; at most 20000 UTF-16 code units. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full burden, and it does disclose genuinely useful behavior: cost (0.001 USDC per call), payment rail (x402 on Base), and that it is paid from the caller's wallet. However, it says nothing about the result shape, failure modes, or what "literally" implies for normalization (whitespace, unicode), which are the traits an agent most needs for a no-annotation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences with the core action front-loaded and pricing second; nothing is redundant. The phrasing "Free sample: textokit_sample" is a little telegraphic but still efficient and useful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations and no output schema, the description is the only source of behavioral information — yet it never describes what a comparison returns, which is the central unknown for this tool. Pricing and the sample pointer are covered, but the return contract and comparison semantics are missing entirely.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both parameters (original, entrega) are fully documented including the 20000 UTF-16 code-unit limit, which sets the baseline at 3. The description adds no meaning beyond the schema — notably it never clarifies that original is the reference baseline and entrega is the candidate being compared, a distinction the Spanish names only weakly convey.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
"Compare texts literally" gives a verb and a resource, and "literally" hints at exact/character-level comparison rather than semantic matching, which helps distinguish it from textokit_translate_es or textokit_source_bounded_summary. But it never says what the comparison actually produces (a diff, a boolean, a similarity score, a list of differences), so an agent can't fully predict the operation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only routing hint is "Free sample: textokit_sample," which tells the agent where to try before paying but not when this tool is the right choice versus other siblings. There is no stated precondition (e.g., both strings must be in the same language, ordering of original vs entrega as the reference) and no 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.
textokit_crypto_pricesAInspect
Precios de criptomonedas en USD. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| coins | Yes | Comma-separated list of 1–20 distinct lowercase CoinGecko… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does disclose the two things an agent most needs: cost (0.001 USDC per call) and the payment mechanism (x402 on Base, from your wallet). It stops short of stating what happens on payment failure, whether calls are retried or charged twice, or what the payload looks like.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences: purpose first, then price/mechanism, then the free alternative. Nothing is repeated and nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter read tool with a fully described schema, the essentials are covered: what it returns conceptually (USD prices), what it costs, and a free alternative. The notable gap is the absence of an output schema paired with no description of the response shape, but the risk of misinvocation is low.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single 'coins' parameter, so the schema already explains the comma-separated CoinGecko ID format and the 1–20 limit. The description adds nothing about parameter syntax or failure modes for invalid IDs, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: prices of cryptocurrencies denominated in USD. That is clear enough to separate it from the text-processing siblings, but it never explicitly contrasts with the closest neighbors (textokit_fx_rates, textokit_dolar_ar), leaving the crypto-vs-fiat boundary to inference.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only routing guidance is 'Free sample: textokit_sample', which is a useful escape hatch but not a when-to-use rule. Nothing says when to prefer this over textokit_fx_rates or textokit_dolar_ar, nor what prerequisites (wallet balance) are needed before calling.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_cuit_arAInspect
Validate Argentine CUIT or CUIL tax id (check digit, KYC onboarding). 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Optional caller-declared type: auto, CUIT or CUIL. Defaults… | |
| identifier | Yes | Eleven digits or XX-XXXXXXXX-X format, supplied as text; up… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and does disclose the critical operational trait: 0.001 USDC per call charged via x402 on Base from the caller's wallet, so the agent knows payment/auth is required. It doesn't describe the pass/fail response shape or how malformed input is handled, leaving a moderate gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short clauses: purpose first, cost second, free alternative last. No filler, and the most decision-relevant facts are front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 2-parameter validator with no output schema, the essential facts (what is validated, cost, payment rail, free sample) are present. The one missing piece is what a successful call returns, which an agent must infer.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the enum for type plus the identifier format rules are already documented in the schema. The description only hints at the check-digit concept and adds no format or defaulting detail beyond structured fields, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Validate Argentine CUIT or CUIL tax id') plus the concrete scope of checks ('check digit'), and names the KYC onboarding use case. It is unmistakable against siblings like textokit_direcciones_ar or textokit_dev_utils.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Points the agent at textokit_sample as a free alternative before paying, which is real routing guidance. It does not state exclusions (e.g. what to do for non-Argentine IDs or when validation should be skipped), so it stops short of a full when/when-not rule set.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_dev_utilsAInspect
Hash, HMAC, JWT decode, UUID, base64 and time zone utilities. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | Operation to run. | |
| to | No | IANA target time zone for tz_convert (default UTC). | |
| from | No | IANA source time zone for tz_convert (default UTC). | |
| value | No | Input text, token, URL, timestamp or local datetime (depends… | |
| secret | No | Secret for hmac or for optional HS256 verification in… | |
| algorithm | No | Hash algorithm for hash and hmac (default sha256). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It usefully discloses pricing (0.001 USDC per call) and the x402/Base wallet payment model, plus a free sample alternative, but it does not state whether operations are read-only, what errors or payment failures look like, or what the response format is.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two compact sentences. The operation list is front-loaded, and the pricing/payment note is important and efficiently stated. There is no wasted text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a multi-operation utility with six parameters and nine enum operations, the description covers the broad operation families and payment model but omits two enumerated operations and gives no per-operation behavioral detail. The schema fills most parameter gaps, but the absence of annotations or an output schema leaves the description somewhat incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 each parameter, including enum values and defaults. The description adds only a high-level operation list and does not explain how parameters like `value`, `secret`, and `algorithm` behave per operation, so it meets the baseline rather than adding meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names specific operation families (hash, HMAC, JWT decode, UUID, base64, time zone) that map closely to the `op` enum, so an agent can tell what the tool does. It is not fully precise because it omits some supported operations like `url_parse` and `unix_to_iso`, and calls itself 'utilities', but the overall purpose is clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage through the listed operations and points to `textokit_sample` as a free alternative. However, it does not explicitly say when to use this tool versus the sample or other siblings, nor does it describe selection conditions for individual operations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_direcciones_arAInspect
Argentine address candidates from Georef. 0.002 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum returned candidates, from 1 to 10; defaults to 5. | |
| direccion | Yes | Address text, from 3 to 200 characters. Locality text alone… | |
| provinciaId | No | Optional two-digit province identifier, preserving leading… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, and it does disclose the most operationally critical trait: 0.002 USDC per call paid via x402 on Base from the caller's wallet, so the agent knows payment and wallet auth are required. It says nothing about behavior on no-match, invalid input, rate limits, or whether results are ranked, which leaves meaningful gaps for a paid read tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences with no filler: purpose first, then the price/payment requirement, then the free alternative. Front-loaded and each sentence carries a distinct, useful signal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a three-parameter tool with full schema coverage, the main remaining need is what a 'candidate' looks like — there is no output schema, and the description never says whether results include coordinates, normalized street names, or match scores. Pricing is covered, return shape and no-match behavior are not.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so direccion, provinciaId, and limit are already documented with ranges and patterns; the baseline of 3 applies. The description adds nothing about parameter semantics, such as what format direccion expects or whether provinciaId improves precision.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific resource and source: 'Argentine address candidates from Georef' — an agent knows this is an address lookup/geocoding tool scoped to Argentina. It stops short of naming a verb (search, normalize, validate) or differentiating it from the address-adjacent siblings, so it is clear but not sibling-distinguishing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only routing guidance is cost-driven: 'Free sample: textokit_sample' tells the agent there is a free alternative to try first. There is no statement of when this tool is preferred over textokit_cartas_ar or other Argentine-data siblings, and no exclusions or input-quality preconditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_dolar_arAInspect
Argentina dollar exchange rates. 0.002 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry the full behavioral burden. It discloses cost (0.002 USDC per call via x402 on Base) and a free sample alternative, which is valuable. However, it omits important behavioral details such as which dollar rates are included (official, blue, etc.) and the return format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is highly concise and front-loaded with the core resource, followed by cost and a sample alternative. Every sentence is informative and there is no waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity (no parameters, no output schema), the description covers the essentials of purpose and cost but lacks details about the specific data returned (e.g., whether it includes historical rates or multiple dollar types) and usage context, leaving gaps for an agent to infer.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, so the baseline is 4. The description does not need to explain parameter semantics, and it appropriately focuses on other aspects.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific resource: 'Argentina dollar exchange rates'. While it lacks a verb like 'get' or 'retrieve', it clearly identifies the data provided and distinguishes itself from more general siblings like textokit_fx_rates by its Argentina-specific focus.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for Argentina dollar rates and points to a free sample alternative (textokit_sample), but it does not explicitly state when to use this tool versus alternatives like textokit_bcra_indicadores or textokit_fx_rates. There are no exclusions or conditions given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_fx_ratesBInspect
FX rates: daily exchange rates for USD, EUR, ARS, BRL and 160 currencies. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| base | No | Base currency, ISO 4217 (default USD). | USD |
| quotes | No | Comma-separated quote currencies, 1 to 20 ISO 4217 codes. | EUR,GBP,BRL,ARS,MXN,JPY |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears the full load — and it does disclose the critical non-obvious trait: this is a paid call at 0.001 USDC via x402 on Base, charged to the caller's wallet, with a free sample as alternative. That is genuinely valuable. However, it says nothing about the response shape, rate timestamp/date semantics, or error behavior when a currency code is unsupported, which matter for a data-fetch tool with zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences with the resource named first, followed by cost and the free alternative — a sensible front-loaded order. No filler, though the currency list in sentence one partially duplicates what the schema already conveys.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a two-parameter, no-output-schema tool, the essentials (what it returns conceptually, what it costs, how to try it free) are present. What is missing is anything about the returned data's freshness, date coverage, or failure modes, which the agent would need to decide between this and the free/alternative rate tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% — both 'base' (default USD, ISO 4217) and 'quotes' (comma-separated, 1–20 codes) are fully documented in the schema. The description reinforces supported currencies but adds no syntax, default, or limit detail beyond what the schema already says, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific resource (daily FX exchange rates) and enumerates representative currencies, so an agent immediately knows this is the currency-rate tool rather than a crypto or Argentina-indicator one. It does not explicitly name the sibling tools it displaces (textokit_crypto_prices, textokit_dolar_ar, textokit_bcra_indicadores), so the differentiation is implied rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage context is implied by 'daily exchange rates' and the pointer to textokit_sample as a free trial, which is a useful fallback route. But there is no explicit when-to-use/when-not, no guidance on choosing between this and the overlapping siblings (dolar_ar, bcra_indicadores, crypto_prices), and no note on freshness or historical coverage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_normativa_arAInspect
Argentina Boletin Oficial search: official gazette notices with excerpts. 0.005 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional publication date, YYYY-MM-DD, selecting daily mode.… | |
| limit | No | Maximum notices to read, from 1 to 10; default: 3. | |
| query | Yes | Nonempty keyword or search text, up to 200 UTF-16 units. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden and it does add genuinely useful behavior: per-call pricing of 0.005 USDC, x402 payment on Base from the caller's wallet, and a free sample escape hatch. It omits failure/payment-failure behavior, any rate or coverage limits, and the shape of returned notices beyond 'excerpts'.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences with zero filler; the purpose is front-loaded and pricing/sample follow as secondary facts. Nothing repeats the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a three-parameter, read-only search with no output schema and no annotations, the description covers purpose, cost model, and an alternative. The main remaining gap is return-value shape: 'notices with excerpts' hints at it but does not say what fields or how many results come back beyond the limit.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so 'query', 'date' (daily mode, YYYY-MM-DD) and 'limit' (1-10, default 3) are already fully documented in the schema. The description adds no parameter-level meaning such as query syntax, stemming, or what a date-scoped call returns relative to a keyword call, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Boletin Oficial search: official gazette notices with excerpts') and pins the jurisdiction to Argentina, which separates it from the sibling source tools like textokit_cartas_ar and textokit_bcra_indicadores. It stops short of explicitly contrasting with the closest sibling (textokit_sample), so it is clear but not fully disambiguated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only routing guidance is cost-based: pay per call, or use textokit_sample for a free sample. There is no statement of when this source is the right one versus the other source-bound tools, and no mention that supplying 'date' switches to a different (daily) retrieval mode. Usage is implied by the tool name rather than explained.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_polymarket_marketsCInspect
Mercados y datos públicos de Polymarket. 0.002 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| user | No | Public wallet address required for positions and activity;… | |
| limit | No | Upstream page size before local filtering; defaults to 5. A… | |
| order | No | Descending ordering within the received market page; missing… | |
| query | No | Case-insensitive substring search in question and slug… | |
| offset | No | Offset passed to the upstream endpoint before local… | |
| status | No | Filter the received market page. Active requires active=true… | |
| resource | No | Defaults to markets. Positions and activity require user. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, and it does add genuinely useful non-schema behavior: the 0.002 USDC per-call cost paid via x402 on Base and the existence of a free sample. However, it omits pagination/filtering behavior, response shape, and failure modes for a 7-parameter tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded, with zero filler and the pricing constraint placed prominently. It is efficient, though the opening sentence's vague framing slightly undercuts the front-loading value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Cost and sample routing are covered, and the rich schema fills in parameter details, so the definition is minimally usable. But for a 7-param, no-annotation, no-output-schema tool with three resource modes, the description should at least explain the resource branch and pagination behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 all seven parameters including enums and defaults. The description adds nothing beyond the schema for any parameter, which is the baseline-3 case.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
It names the resource (Polymarket markets and public data) but uses no specific verb, so an agent can't tell whether it fetches, searches, or streams. The description also fails to surface that the same tool serves positions and activity via the 'resource' parameter, which is only discoverable in the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only guidance offered is a pointer to the free sample for trying it out; there is no statement of when to call this versus other data siblings like textokit_crypto_prices or textokit_x402_adoption. The constraint that positions/activity require a user wallet is left entirely to the schema.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_sampleBInspect
Free sample of one route: same schema as the paid output plus an inputExample. Use it before paying.
| Name | Required | Description | Default |
|---|---|---|---|
| route | Yes | Route name, e.g. web-read |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses the free-versus-paid distinction and that an extra inputExample is included, which is real behavioral context. It does not say whether the sample returns live or illustrative data, whether calls are capped, or what a caller should expect for a route that doesn't exist, leaving meaningful gaps for a trial tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, front-loaded with the free-sample fact and wasting no words. The phrase 'same schema as the paid output' is slightly compressed and would read better as 'same response shape as the corresponding paid tool'.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, so the description is the only place return values can be explained; it gestures at this by referencing the paid output schema plus an inputExample. It omits whether sample data is live or illustrative, which is the one thing an agent most needs to know before relying on the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single enum parameter is documented in the schema, so the baseline of 3 applies. The description never mentions the route parameter or explains that its enum values mirror the sibling tool names, so it adds nothing beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
It states this is a free sample of one route with the same schema as the paid output plus an inputExample, which does separate it from the nineteen paid siblings. But 'sample' is not a concrete verb — it doesn't say whether the tool returns mock data, real data, or a truncated response — so the agent's picture of what comes back stays fuzzy.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'Use it before paying' is an explicit usage condition that routes the agent here instead of the paid route tools. It lacks a when-not clause (e.g. what to do once the caller has paid, or whether samples are rate-limited), but the intended sequencing is clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_source_bounded_summaryAInspect
Summarize text with verified quotes (evidence-bound summary). 0.002 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to summarize; 1–4000 characters. Do not submit secrets… | |
| language | No | Optional summary language: es or en. Defaults to es. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, and it does disclose the key behavioral fact an agent must know: this is a paid call at 0.002 USDC via x402 on Base from the caller's wallet, with a free sample alternative. It omits failure modes, what happens if no verifiable quotes are found, rate limits, and the shape of the returned evidence, which are significant gaps for a metered tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, zero filler, with the core capability front-loaded and the pricing/alternative details following. Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema and no annotations, so the description is the only place an agent can learn about cost and payment mechanics, which it does cover. It still leaves the return payload (how quotes/evidence are presented) and error behavior unexplained, which matters for a paid, evidence-verified endpoint.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, including the 1–4000 character bound and the es/en enum with a stated default, so the schema does the heavy lifting. The description adds no parameter-level meaning beyond that, which is the correct baseline of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Summarize text') plus a distinguishing qualifier ('verified quotes / evidence-bound summary'), which separates it from a generic summarizer. It does not explicitly contrast with any sibling beyond pointing at the free sample, so a 4 rather than a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The one piece of routing guidance is the pointer to textokit_sample for a free trial, which is genuinely useful for a paid tool. However, there is no statement of when to prefer this over alternatives, no exclusions, and no guidance on constraints such as maximum input size or when the quote requirement will fail.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_translate_esAInspect
Translate to Spanish (Argentina): rioplatense voseo, any source language. 0.003 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to translate into Rioplatense Spanish; 1–6000… | |
| tone | No | Optional tone: formal, neutral or casual. Defaults to… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of disclosure and does deliver the critical operational facts: cost (0.003 USDC per call), payment rail (x402 on Base) and that it is charged from the caller's wallet. It does not describe the response shape or failure/refund behavior, so it stops short of full transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short clauses, front-loaded with the capability, then cost, then the free-sample escape hatch. Nothing is redundant or padded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a two-parameter, no-output-schema tool, the description covers purpose, dialect target, pricing model and a free alternative. Only the return format and input-handling edge cases are left unstated, which are minor at this complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so both text and tone are already documented in structured fields; the description adds only the dialect nuance. Baseline 3 is appropriate since the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ("translate to Spanish (Argentina)") plus a differentiating dialect constraint (rioplatense voseo) and scope (any source language). No sibling tool does translation, so an agent can select it unambiguously from the list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is only implied: it names textokit_sample as a free trial path, which is a useful routing hint, but there is no explicit when-to-use vs when-not, nor guidance on picking a tone or handling unsupported inputs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_url_textAInspect
Texto legible de una página pública. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public HTTPS page URL. Private addresses and pages requiring… | |
| format | No | Output format: plain text or simple Markdown. Defaults to… | text |
| maxChars | No | Maximum returned text length in UTF-16 code units, from 1000… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations at all, the description carries the full burden and does disclose the critical behavioral trait: this is a paid call (0.001 USDC, x402 on Base, charged to the caller's wallet), plus a free sampling path. It omits failure modes, wallet/auth prerequisites in detail, and any rate-limit or error behavior, which keeps it 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences with zero filler: what it returns, what it costs, and the free alternative. The core capability is front-loaded and the pricing caveat follows immediately.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 3-parameter, fully-described schema with no output schema, an agent has enough to call it: it knows the input is a public HTTPS URL and that output is readable text, optionally truncated. The cost model is disclosed, though the shape of the returned payload (beyond 'readable text') and the maxChars truncation consequence are not spelled out.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the url, format enum, and maxChars bounds are already fully documented in structured fields. The description adds no parameter-level meaning beyond that, making the baseline 3 correct.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Names a concrete operation and resource: extracting readable text from a public page. It distinguishes itself from textokit_sample by framing that one as the free trial, but it does not differentiate from the closely related sibling textokit_web_read, which an agent could easily confuse with it.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied (you want readable text from a public page) and the description does route cost-sensitive agents to the free sample first. However, it gives no guidance on when to prefer this over textokit_web_read or textokit_source_bounded_summary, so the main sibling ambiguity is left unresolved.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_web_readAInspect
Web page to Markdown: read any public URL as clean text. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public HTTPS page URL. Private addresses and pages requiring… | |
| format | No | Output format: plain text or simple Markdown. Defaults to… | text |
| maxChars | No | Maximum returned text length in UTF-16 code units, from 1000… |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It usefully discloses the cost model (0.001 USDC per call via x402 on Base from a wallet) and the free-sample alternative, but it omits details such as payment flow, rate limits, error behavior, and output truncation beyond what the schema covers.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three short sentences with no wasted language. It front-loads the core purpose, then payment terms, then the free-sample pointer.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is moderately simple, but with no annotations and no output schema, the description should do more to set expectations about returns and payment prerequisites. It adequately covers purpose, cost, and public-URL scope, but leaves payment-flow and output-shape details implicit.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 url, format, and maxChars in detail. The description adds no parameter-specific meaning beyond the schema, which is the expected baseline when schema coverage is complete.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb and resource: 'read any public URL as clean text' and 'Web page to Markdown.' It is clear what the tool does, but it does not explicitly distinguish this tool from sibling textokit_url_text, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage by saying it reads any public URL and points to textokit_sample for a free sample. However, it does not explain when to choose this paid tool over similar siblings such as textokit_url_text, nor does it state exclusions beyond public URLs.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_x402_adoptionBInspect
x402 Bazaar stats: what agents actually buy, with sources. 0.005 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| section | No | Which part of the report to return. overview: headline… | overview |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, and it discloses the key non-obvious trait: 0.005 USDC per call, paid via x402 on Base from the caller's wallet. That is a real payment/auth precondition an agent must know before invoking, though return shape and failure modes (unpaid call behavior) are not covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded with the subject and the price, and the free alternative last. Dense and mostly waste-free, though the first sentence is tagline-flavoured rather than informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-param, no-output-schema tool the description covers price, payment rail, and a free fallback, which is decent. It still omits what a caller actually receives (report structure, sources format, freshness) and never ties the 'section' parameter to the described content.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single 'section' parameter has an inline enum with per-value descriptions, so the schema does all the work. The description never mentions 'section' or the report parts, so it adds nothing beyond that baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description calls this "x402 Bazaar stats: what agents actually buy, with sources", which conveys the resource but uses a marketing tagline rather than a specific verb, never saying it returns an adoption report. It is distinguishable from siblings mostly because of the unique 'x402 Bazaar' subject matter, not because of any explicit differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It name-drops textokit_sample as a free sample, which implies a paid-vs-free routing choice, but gives no explicit when-to-use or when-not-to-use guidance. Nothing explains how it relates to siblings like textokit_x402_ping or textokit_source_bounded_summary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
textokit_x402_pingAInspect
x402 ping: cheapest end-to-end test of an x402 payment on Base. 0.001 USDC per call, paid with x402 on Base from your wallet. Free sample: textokit_sample.
| Name | Required | Description | Default |
|---|---|---|---|
| echo | No | Optional text echoed back (up to 200 characters). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry behavioral disclosure. It discloses the key paid-tool trait (0.001 USDC per call, paid via x402 on Base from the user's wallet) and offers a free sample, but omits wallet prerequisites, payment failure or retry semantics, and response behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and front-loaded: purpose and cost first, free alternative second. It is appropriately sized for a simple ping tool with no wasted prose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with no output schema, the description covers purpose, cost, payment rail, and a free alternative. It still leaves response shape, payment success or failure behavior, and wallet setup unexplained, so it is adequate but not complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The single optional echo parameter is fully documented in the schema at 100% coverage, and the description adds no parameter-specific semantics. Baseline 3 applies when schema coverage is high.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific purpose: cheapest end-to-end test of an x402 payment on Base, with per-call cost. It names the free alternative textokit_sample, which helps distinguish it from that sibling, though it does not mention textokit_x402_adoption.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives clear usage context (cheapest paid end-to-end test) and explicitly points to textokit_sample as the free alternative. It does not state explicit exclusions or when to prefer other x402-related siblings.
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.
19 tool updates
v0.1.2- First observed
textokit_bcra_indicadores - First observed
textokit_cartas_ar - First observed
textokit_catalog - First observed
textokit_comparar_textos - First observed
textokit_crypto_prices - First observed
textokit_cuit_ar - First observed
textokit_dev_utils - First observed
textokit_direcciones_ar - First observed
textokit_dolar_ar - First observed
textokit_fx_rates - First observed
textokit_normativa_ar - First observed
textokit_polymarket_markets - First observed
textokit_sample - First observed
textokit_source_bounded_summary - First observed
textokit_translate_es - First observed
textokit_url_text - First observed
textokit_web_read - First observed
textokit_x402_adoption - First observed
textokit_x402_ping
TDQS
Scored across 19 tools
Most routes target distinct resources (CUIT validation, BCRA indicators, Polymarket, letters, hashing), but textokit_url_text and textokit_web_read appear to do the same thing — fetch a public URL as readable text/Markdown — with no clear boundary. The currency cluster (fx_rates, dolar_ar, bcra_indicadores, crypto_prices) is separable via descriptions but still requires reading carefully to pick correctly.
All 19 tools share the textokit_ prefix and snake_case, which is highly predictable. The only deviation is mixed language and style within the suffix: Spanish route names (comparar_textos, dolar_ar, cartas_ar) sit alongside English ones (web_read, source_bounded_summary, crypto_prices), and some are verbs while others are nouns.
19 tools is on the heavy side but justified for a multi-domain paid utility store spanning text, Argentine data, FX/crypto, dev utilities, and x402 plumbing. The two meta tools (catalog, sample) and the ping are shared infrastructure rather than redundant capabilities, so each entry earns its place.
The surface covers the full buying lifecycle — free discovery (catalog, sample), payment smoke test (x402_ping), adoption stats, and a wide spread of paid operations. Gaps are minor: only Spanish/Argentine localization is offered, and there is no tool to inspect payment status, wallet balance, or usage history after a call.
Maintenance
Related MCP Connectors
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
34 pay-per-call AI and data tools over x402; USDC on Base; no API keys.
15 data tools at $0.01 USDC/call on Base via x402. Free discovery; x402 wallet client required.
63 pay-per-call tools for agents: vision, text, data, web, blockchain. USDC on Base via x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI agents with 10 pay-per-call utility tools (QR generation, DNS lookup, OCR, etc.) using USDC on Base via the x402 protocol, with agent's private key never leaving the agent.1119 npmMIT
- FlicenseNot gradedqualityBmaintenanceProvides coding agents with 19 pay-per-call developer utilities, npm supply-chain security checks, and Base blockchain lookups, paid via USDC on Base using x402. No API key needed—payment acts as authentication.42 npm-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to access 11 paid x402 endpoints as standard MCP tools, paying per call in USDC on Base without API keys, covering chat, code, vision, embeddings, crypto prices, weather, geolocation, forex, and WHOIS data.-
- AlicenseAqualityCmaintenancePay-per-call data and tools for AI agents over x402, by UnyKorn. 360 endpoints: DeFi and market data, multi-chain wallet reads, wallet and token risk signals, SEC filings, web and domain intel, and AI text tools. Settled per call in USDC on Base ($0.001-$0.25). No API keys or subscriptions; unpaid calls return the exact quote first.21MIT