Aloha Fungi Developer Platform

One catalog entry point for people, apps and agents

Read live prices and availability through REST, generate a client from OpenAPI or connect an agent through MCP. The same catalog, one explicit contract and no key required for read-only operations.

Open OpenAPI Inspect the live API

Choose your integration path

Every interface leads to the same catalog data. Start with the one that best fits your environment.

OPENAPI 3.1

OpenAPI specification

A compact, typed OpenAPI 3.1 contract with unique operationId values, response schemas and error schemas.

Open resource →REST · JSON

Public REST API

Search products, inspect variants, match a declared goal and search the knowledge base. No authentication required.

Open resource →MCP

MCP server and manifest

A standard server manifest plus Streamable HTTP for agents, including tools that prepare a customer checkout link.

Open resource →

Your first response in seconds

curl

REST needs no key. This request reads the current catalog and returns a consistent data envelope.

curl "https://alohafungi.com/api/v1/products?q=reishi"

MCP

The manifest identifies the official Streamable HTTP transport, its capabilities and the MCP server documentation.

curl "https://alohafungi.com/server.json"

A contract you can rely on

Reads are public

API v1 exposes catalog and knowledge data. Prices are in PLN and availability comes from the live store system.

Errors explain the next move

Every JSON error includes a code, message, resolution and documentation link. An agent never has to guess.

Optional token

Everything works anonymously. A token from /api/oauth/token (client_credentials grant, no secret) lets an agent narrow its own permissions to catalog:read, knowledge:read or checkout:link and give itself a name. Rate limits are counted per IP address either way. Details in auth.md.

The human keeps control

Payment and login are not part of the public API. MCP may prepare a link, but the customer always confirms the purchase themselves.

Educational material and product matching are not a diagnosis or medical advice. Dietary supplements do not replace a varied diet.

API versioning and deprecation policy