Name: tool-card-generate
Price: 0.005 USDC
Availability: InStock

$ man tool-card-generate

agentutility / wordmint / tool-card-generate

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

uncategorized

STATUS

● live

NAME

tool-card-generate — generates an agent tool card from a tool name + plain-english description (and optional parameter hints): a strict openai/a2a-compatible…

SYNOPSIS

POST https://x402.agentutility.ai/tool-card-generate
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Generates an agent tool card from a tool name + plain-English description (and optional parameter hints): a strict OpenAI/A2A-compatible spec of { name, description, parameters: <JSON Schema> }. Powered by Venice zai-org-glm-4.7 in json_object mode. Useful for retrofitting LLM-callable tool descriptions onto existing API endpoints. Use it as an OpenAI function-calling spec generator, A2A tool-card builder, or agent tool description writer.

INPUT — request schema

property	type	description	req?
name	string	Tool name (1-64 chars, snake_case or kebab-case, starts with a letter).	required
description	string	One-sentence description of what the tool does.	required
parameters_hint	string	Free-form hint about parameters: types, names, what they mean. Optional.	optional
example	string	Optional example invocation.	optional

OUTPUT — response shape

field	type	description
tool_card	string	JSON string with the generated tool card object containing name, description, and a JSON Schema parameters block.
model	string	Venice model ID used to generate the tool card (zai-org-glm-4.7).
source	string	Generator identifier indicating the tool card was produced by this endpoint's Venice-backed pipeline.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/tool-card-generate \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the tool-card-generate tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: wordminttool-cardfunction-callingopenai-schemajson-schemaa2aagent-toolstool-card-generator
methods: POST
cluster: wordmint
price: $0.005 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
brand-tagline	Generates brand taglines and slogans for launch pages, X bios, email copy, and product cards.	$0.005
brand-tagline-generate	Generates tagline options for a brand or startup from its name, concept, audience, and tone.	$0.005
card-resolve	Normalizes free-form graded card text into a canonical card object.	$0.005
content-simhash	Fingerprints text with a 64-bit SimHash for near-duplicate detection, computed entirely locally.	$0.005
cron-parse	Cron parser.	$0.005
detect-language	Language detector / language identification.	$0.005
dictionary-define	Looks up English word definitions with pronunciation, part of speech, and synonyms.	$0.005
embedding-similarity	Measures how semantically similar two strings are: embeds both via Venice (default model: text-embedding-bge-m3) and returns the cosine s…	$0.005