Developers

Minoa API, MCP server, and developer resources

Everything an engineer or an agent needs to work with Minoa: a public read-only content API with an OpenAPI description, the authenticated product API, the Minoa MCP server, and Markdown versions of every page.

01

Content API

Read Minoa's public content as JSON

The content API needs no key and no account. It serves the same articles, glossary, pricing, and company details this site renders, so an agent answering a question about Minoa can cite a structured source instead of scraping a page. Every response is JSON, every failure is a JSON envelope with a code, a message, and a resolution, and the whole surface is described at /openapi.json (also served at /.well-known/openapi.json).

GET /api/v1

Index of every endpoint, with links to the OpenAPI description.

GET /api/v1/company

Company profile, registered address, and contact channels.

GET /api/v1/pricing

Published plans, the flat annual platform fee, and the pricing FAQ.

GET /api/v1/posts

Published articles, newest first. Filter with category, limit, and offset.

GET /api/v1/posts/{slug}

One article, including its full Markdown body.

GET /api/v1/glossary

Every value selling glossary term, alphabetically.

GET /api/v1/glossary/{slug}

One glossary term, including its Markdown definition.

Responses are cached and CORS-open. Please keep automated reads to a fair volume; if you need bulk access, write to hello@minoa.io.

02

Build

Minoa product API

The product API covers business cases, value frameworks, global inputs, and analytics inside your workspace. Authentication, endpoints, and worked recipes are documented in the product docs.

docs.minoa.io

Minoa MCP server

A remote Model Context Protocol server over Streamable HTTP at mcp.minoa.io. It authenticates with OAuth, so agents read and write only the value data the signed-in user can already see. Claude, ChatGPT, and Cursor connect natively.

How the MCP server works

Markdown for agents

Every public page on this site returns Markdown when you send the header Accept: text/markdown, or when you prefix the path with /api/md. No HTML parsing, no hydration payload, same URL structure.

Try /api/md/resources

llms.txt

A single plain-text map of the site for language models: what Minoa is, every key page, the comparison hub, the glossary, and the research reports, each with a one-line description.

Read llms.txt
03

Access

Public content API

No authentication. Call it now, from anywhere, and read the OpenAPI description for the exact response shapes.

Product API and MCP

Generate a key from your Minoa workspace settings, or connect the MCP server and approve the OAuth prompt. Both scope access to your own workspace.

No workspace yet

Book a demo and we will set one up. Enterprise plans include bring-your-own MCP and warehouse connectors.

Put value data where your agents already work

Connect the Minoa MCP server, or read the public content API. Both take minutes.