Schema Generation

Schema Generation is the process by which MCP SDKs automatically produce the JSON Schema required to describe a server's tools and prompts.

How it Works

Developers often define their tools using standard language features (like TypeScript interfaces, Python type hints, or Go structs). The MCP SDK then "reflects" on these types to generate the JSON-RPC schema.

Example (TypeScript SDK)

// The developer writes this:
server.tool("calculate_sum", { a: z.number(), b: z.number() }, (args) => args.a + args.b);

// The SDK generates this JSON-RPC schema:
// { "type": "object", "properties": { "a": { "type": "number" }, "b": { "type": "number" } } }

Benefits

Dynamic Schema Generation in HasMCP

While code-first SDKs provide reflection-based generation, HasMCP offers a declarative, no-code approach to schema generation. By analyzing an API's specification on the fly, HasMCP dynamically generates the necessary JSON-RPC tool definitions. This allows for rapid deployment of new tools and allows agents to adapt to underlying API changes in real-time without recompiling code.

Questions & Answers

What is "Schema Generation" in MCP SDKs?

Schema generation is the process of automatically creating JSON schemas to define a server's tools and prompts. it ensures that the host application understands the required input format for every capability the server exposes.

How do modern SDKs use "reflection" to generate JSON schemas?

SDKs "reflect" on standard language features—like TypeScript interfaces or Python type hints—to programmatically determine the data types and structures needed for a tool. This eliminates the need for developers to manually write JSON schemas.

How does HasMCP's approach to schema generation differ from traditional SDKs?

Unlike traditional SDKs that require code-first reflection, HasMCP uses a declarative no-code approach. It analyzes API specifications (like OpenAPI) in real-time to generate tool definitions dynamically, allowing for faster deployment and adaptation.

Back to Glossary