---
title: "MCP Tool-Definition Linter & Annotation Designer"
method: POST
path: "/v1/tools/lint_mcp_tool_definition"
tags: ["MCP", "tool definition", "JSON Schema 2020-12", "annotations", "linter", "agent tooling"]
---

# MCP Tool-Definition Linter & Annotation Designer

`POST /v1/tools/lint_mcp_tool_definition`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/lint_mcp_tool_definition`
- Auth: none declared

Lints a Model Context Protocol tool definition (name, description, inputSchema, outputSchema, annotations) against JSON Schema 2020-12 and current MCP tool-naming and annotation rules, scores conformance, and designs a consistent annotation set. Reference rules are static and may age — verify against the live MCP specification.

**Tool URL:** https://ainumbers.co/tools/274-mcp-tool-definition-linter.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `tool_definition` object, required: The MCP tool definition to lint.

## Response `200`

Successful tool execution result

- object
  - `score` number
  - `findings` object[]
  - `annotations` object

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)