Skip to content

NeNe health catalog example

Copy this to docs/mcp/tools.json in your NeNe app. Aligned with NeNe docs/api/openapi.yaml (operationId: healthCheck).

json
{
  "tools": [
    {
      "name": "getHealthCheck",
      "title": "Health Check",
      "description": "GET /health/index (operationId healthCheck).",
      "safety": "read",
      "source": {
        "type": "openapi",
        "operationId": "healthCheck",
        "method": "GET",
        "path": "/health/index"
      },
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "responseSchemaRef": null
    }
  ]
}

Subdirectory deploy (URI_ROOT)

When NeNe runs under a path prefix, set NENE_MCP_API_BASE_URL to include that prefix (e.g. http://localhost:8080/mybiz). Catalog paths stay route-relative (/health/index). Details: NeNe catalog patterns.

Verify

bash
export NENE_MCP_API_BASE_URL=http://localhost:8080
export NENE_MCP_TOOLS_JSON=/ABS/PATH/docs/mcp/tools.json
printf '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"getHealthCheck","arguments":{}}}\n' \
  | php vendor/bin/nene-mcp

Expect statusCode 200 in structured content.

Released under the MIT License.