# inputSchema is present

**inputSchema is a required field of every MCP tool and must be a JSON Schema object, not null; a tool with no arguments uses {"type": "object", "additionalProperties": false}.**

Check `spec-input-schema-missing` · MCP specification 2026-07-28 · default severity: blocking · rubric 2.1.0. Last verified against MCP specification 2026-07-28: Tools on 2026-11-18.

## Error message you’ll see

```text
tools.0.custom.input_schema.type: Field required
```

Claude API (400), when the root has no "type": "object". Where this was reported: https://github.com/langchain-ai/langchainjs/issues/11240

## What fails

inputSchema is a required field of a tool. Without it, clients cannot build or validate the arguments.

## The rule

> MUST be a valid JSON Schema object (not `null`)

Source: [MCP specification 2026-07-28: Tools](https://modelcontextprotocol.io/specification/2026-07-28/server/tools#tool)

## How to fix it

Add an inputSchema. A tool with no arguments uses {"type": "object", "additionalProperties": false}.

1. Add an inputSchema to every tool the server lists.
2. For a tool without arguments, use {"type": "object", "additionalProperties": false}.
3. With an SDK, pass an empty object schema rather than leaving the field out.

Before:

```json
{ "name": "get_time", "description": "Returns the server time." }
```

After:

```json
{ "name": "get_time", "description": "Returns the server time.", "inputSchema": { "type": "object", "additionalProperties": false } }
```

### TypeScript SDK

```ts
import { McpServer } from '@modelcontextprotocol/server';
import * as z from 'zod';

const server = new McpServer({ name: 'issues', version: '1.0.0' });

server.registerTool(
  'get_server_time',
  {
    title: 'Get server time',
    description: 'Return the current server time in UTC. Use when the user asks what time the service uses.',
    inputSchema: z.strictObject({}),
    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
  },
  async () => ({ content: [{ type: 'text', text: 'Done' }] }),
);
```

### Python SDK

```python
from typing import Annotated

from pydantic import Field
from mcp.server.mcpserver import MCPServer
from mcp.types import ToolAnnotations

server = MCPServer("issues")

@server.tool(
    title="Get server time",
    annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False, openWorldHint=False),
)
def get_server_time() -> str:
    """Return the current server time in UTC. Use when the user asks what time the service uses."""
    return "Done"
```

## Questions

### What inputSchema should a tool without arguments have?

{"type": "object", "additionalProperties": false}. It says the tool takes an empty object and nothing else. Both SDKs emit it from an empty argument list.

### Is inputSchema: null allowed?

No. The specification says it MUST be a valid JSON Schema object, not null.

## Related checks

- [inputSchema has type "object" at the root](https://isokron.ai/mcp-check/checks/spec-input-schema-root-object)
- [The schema field is named inputSchema](https://isokron.ai/mcp-check/checks/spec-input-schema-field-name)
- [inputSchema and outputSchema are valid JSON Schema](https://isokron.ai/mcp-check/checks/spec-schema-valid)
- [MCP tool input and output schemas](https://isokron.ai/mcp-check/checks/schema)

Counts toward: MCP specification 2026-07-28.

Rubric: https://isokron.ai/mcp-check/rubric

Check your tool list: https://isokron.ai/mcp-check
