Python MCP Template

Instructions

{
  "message": "Hello, world!"
}

{
  "detail": [
    "unknown_type"
  ]
}

Implementation Reference

• mcp_tools/main.py:15-16 (handler)

  The handler function for the "new_endpoint" MCP tool. It receives a NewEndpointRequest with a 'name' field and returns a greeting message in NewEndpointResponse format.

  async def new_endpoint(request: NewEndpointRequest):
      return {"message": f"Hello, {request.name}!"}

• mcp_tools/main.py:12-14 (registration)

  FastAPI route decorator that registers the new_endpoint handler as an MCP tool using operation_id="new_endpoint". FastMCP.from_fastapi will expose this as an MCP tool.

  @app.post(
      "/new/endpoint/", operation_id="new_endpoint", response_model=NewEndpointResponse
  )

• mcp_tools/schemas.py:8-11 (schema)

  Pydantic input schema (NewEndpointRequest) for the new_endpoint tool, defining the 'name' parameter.

  class NewEndpointRequest(BaseModel):
      name: str = Field(
          ..., description="The name to include in the message.", examples=["developer"]
      )

• mcp_tools/schemas.py:4-5 (schema)

  Pydantic output schema (NewEndpointResponse) for the new_endpoint tool, defining the 'message' response.

  class NewEndpointResponse(BaseModel):
      message: str = Field(..., description="A welcome message.", examples=["Hello, world!"])

• mcp_tools/main_http.py:19-20 (handler)

  Identical handler function for the "new_endpoint" tool in the HTTP-optimized main file.

  async def new_endpoint(request: NewEndpointRequest):
      return {"message": f"Hello, {request.name}!"}