Home Getting Started Human Spec LLM Spec

Reference Cards for LLMs

These compact markdown files teach LLMs how to work with MAPI. Attach one to your chat, or tell your LLM to fetch it directly.

Each card is optimized for token efficiency—containing only what an LLM needs for that specific task.

Available Reference Cards

Choose the card that matches what you want your LLM to do.

MAPI Author

Teaches an LLM to write MAPI specifications from scratch. Describe your API and get a complete spec.

Open Markdown Learn More
Fetch: https://markdownapi.org/specs/MAPI-AUTHOR.md

OpenAPI to MAPI

Converts OpenAPI/Swagger specifications to MAPI format. Handles field mapping and type conversion automatically.

Open Markdown Learn More
Fetch: https://markdownapi.org/specs/OPENAPI-TO-MAPI.md

AsyncAPI to MAPI

Converts AsyncAPI specifications for WebSocket and event-driven APIs to MAPI's unified format.

Open Markdown Learn More
Fetch: https://markdownapi.org/specs/ASYNCAPI-TO-MAPI.md

MAPI to OpenAPI

Exports MAPI specifications to OpenAPI 3.1 format for use with legacy tooling and code generators.

Open Markdown Learn More
Fetch: https://markdownapi.org/specs/MAPI-TO-OPENAPI.md

MAPI Validator

Validates MAPI documents for structural correctness, catching missing sections, invalid transport strings, and more.

Open Markdown Learn More
Fetch: https://markdownapi.org/specs/MAPI-VALIDATOR.md

Full MAPI Specification

The complete MAPI v0.93 specification. Use this when you need comprehensive understanding of all MAPI features and syntax.

Open Markdown Human Version
Fetch: https://markdownapi.org/specs/mapi-specification-v0.93.md

How to Use

1

Choose a Card

Pick the reference card that matches your task—writing, converting, exporting, or validating.

2

Give it to Your LLM

Either attach the markdown file, paste it directly, or tell the LLM to fetch the URL.

3

Describe What You Need

The reference card teaches the format. You just describe your API or paste your existing spec.