BRAINIAC Agent Tool Schema Description Scorer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).
Scores and validates AI agent tool schema descriptions for quality, flagging missing purpose, inputs, outputs, and usage guidance
Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.
Returns a numeric score (0–100) representing average description quality across all submitted tools, plus a list of issues (with severity, location, type, and suggested fix), warnings for missing input/output documentation, recommendations for usage guidance, an analysis summary string, and a list of checker limitations.
POSThttps://www.brainiac.software/api/v1/agent-tool-schema/tool-schema-description-score?utm_source=zero.xyzUse this endpoint when you need a fast, deterministic, heuristic-based quality score for agent tool schemas — particularly before publishing or deploying tools to an agent marketplace. Prefer this over manual review when you need structured, machine-readable feedback at scale. It is especially useful for CI/CD pipelines validating tool documentation quality. Not suited for semantic correctness checks or natural language quality judgments beyond phrase matching.
| Field | Type | Description |
|---|---|---|
| tools | array | |
| openapi | object | |
| schemas | array |
{
"type": "json",
"example": {
"score": 58,
"issues": [
{
"type": "unclear_purpose",
"evidence": "Search stored orders.",
"location": "tools[0]",
"severity": "medium",
"description": "The description is missing or shorter than 40 characters, so an agent may not know the tool's purpose.",
"suggested_fix": "Write at least 40 characters that state what the tool does."
}
],
"success": true,
"analysis": "Scored 2 descriptions. The score is the average of the per-tool checks.",
"warnings": [
{
"type": "inputs_not_stated",
"location": "tools[0]",
"description": "The description does not mention inputs and no property has a description."
},
{
"type": "outputs_not_stated",
"location": "tools[0]",
"description": "The description does not mention a result and no output schema was supplied."
}
],
"limitations": [
"Checks use the supplied JSON only. No schema URL is fetched and no model reads the text.",
"Supported dialects for keyword checks are JSON Schema draft-07, JSON Schema 2020-12, OpenAPI 3.0, and OpenAPI 3.1. Other drafts are reported only when a keyword is on the target ban list.",
"Example validation understands type, enum, const, properties, required, additionalProperties as a boolean, items, numeric and length bounds, and anyOf, oneOf, and allOf. A $ref is resolved only inside the same document at #/$defs, #/definitions, or #/components/schemas.",
"Purpose requires a description of at least 40 characters that is not the tool name. Inputs match input, parameter, provide, accepts, or pass, or a property description. Outputs match return, output, result, or responds, or an output schema. Usage matches use when, when the, call this, or do not use.",
"These are phrase checks. They do not judge whether the description is true.",
"Missing purpose subtracts 30. Missing inputs or outputs subtract 20 each. Missing usage subtracts 15. The reported score is the average across tools."
],
"recommendations": [
{
"type": "usage_not_stated",
"location": "tools[0]",
"description": "The description has no phrase such as use when or do not use."
}
]
}
}No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"