API & MCP

Everything a person can do on Household Plant Fit, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://hearthplantfit.usefulweb.app/api/v1/calculate – run Household Plant Fit
GET https://hearthplantfit.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Household Plant Fit

Compare twenty-four identified houseplants by light, space and care effort, with scientific-name aliases and species-specific ASPCA/RHS references.

Inputs of Household Plant Fit
Field	Type	Default	Description
`light`	select (bright, low, direct)	"bright"	Light conditions
`care`	select (easy, moderate, attentive)	"moderate"	Maximum care effort
`pets`	boolean	true	Only ASPCA-listed non-toxic choices for cats and dogs
`space`	select (any, compact, medium, large)	"any"	Space
`query`	text	—	Plant name or scientific alias

Example request

Try an example

curl -X POST https://hearthplantfit.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://hearthplantfit.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: hearth_plant_fit
Local stdio connector: node src/mcp-stdio.ts --tool=hearth-plant-fit

{
  "mcpServers": {
    "hearth-plant-fit": { "type": "http", "url": "https://hearthplantfit.usefulweb.app/mcp" }
  }
}