# AGENTS.md

Minimal Data API I/O: a content transformation layer primitive for AI systems. Transforms files and webpages into AI-ready Markdown and structured data, optimized for LLM efficiency and token usage.

## Start here

https://mdapi.io/.well-known/ai-discovery.json is the whole surface in one document: every protocol, every endpoint and every capability. This file is only the shortest path to a first answer.

## The one call

```
GET  https://mdapi.io/?input=<document address, or the text itself>
POST https://mdapi.io/   {"input":"<document address, data URI or text>","prompt":"Summarize"}
```

`input` is read from the value, not from a header: an address is fetched, a `data:` URI is decoded, anything else is the text itself. Without `prompt` the answer is the document as Markdown; with it the document is read and the question answered over it.

## Protocols

REST, MCP, A2A, ACP and an OpenAI-compatible endpoint answer the same conversion core, so a client keeps the protocol it already speaks. The address of each one is in https://mdapi.io/.well-known/ai-discovery.json.

## Payment

A request that needs paid work answers `402`, and that answer carries what is needed to pay: the amount, the network, the receiving address, the reference and a QR code for a human. https://mdapi.io/.well-known/x402.json is the payment manifest; https://mdapi.io/auth.md is the flow, from the first request to the token that replaces it.

## Read next

- https://mdapi.io/auth.md - obtaining, using and rotating access
- https://mdapi.io/.well-known/openapi.json - the REST surface as OpenAPI 3.1.0
- https://mdapi.io/.well-known/skill.md - the conversion skill, step by step
- https://mdapi.io/.well-known/mapi.md - the request and response contract, surface by surface
- https://mdapi.io/docs - the documentation pages
- https://mdapi.io/llms.txt - the documentation index

## Links

- **About service:** https://mdapi.io/about
- **Privacy:** https://mdapi.io/privacy
- **Contact:** https://mdapi.io/contact
- **Agent entry point:** https://mdapi.io/AGENTS.md or https://mdapi.io/agents.md or https://mdapi.io/agent.md
- **Agent access:** https://mdapi.io/auth.md
- **API documentation and conversion:** https://mdapi.io
- **MCP server manifest:** https://mdapi.io/mcp
- **Health check:** https://mdapi.io/health
- **Documentation index:** https://mdapi.io/llms.txt
- **Full API documentation:** https://mdapi.io/llms-full.txt
- **AI discovery:** https://mdapi.io/.well-known/ai-discovery.json or https://mdapi.io/ai-discovery.json
- **AI Agent discovery:** https://mdapi.io/.well-known/agent.json or https://mdapi.io/agent.json
- **A2A Agent card:** https://mdapi.io/.well-known/agent-card.json or https://mdapi.io/agent-card.json
- **ACP manifest:** https://mdapi.io/.well-known/acp.json or https://mdapi.io/acp.json
- **x402 payment manifest:** https://mdapi.io/.well-known/x402.json or https://mdapi.io/x402.json or https://mdapi.io/.well-known/x402
- **OpenAPI specification (JSON):** https://mdapi.io/.well-known/openapi.json or https://mdapi.io/openapi.json
- **OpenAPI specification (YAML):** https://mdapi.io/.well-known/openapi.yaml or https://mdapi.io/openapi.yaml
- **MAPI specification:** https://mdapi.io/.well-known/mapi.md or https://mdapi.io/mapi.md
- **Skill specification:** https://mdapi.io/.well-known/skill.md or https://mdapi.io/skill.md
- **ARD manifest:** https://mdapi.io/.well-known/ard.json or https://mdapi.io/.well-known/ai-catalog.json or https://mdapi.io/ard.json
- **Agent Plugins manifest:** https://mdapi.io/.well-known/plugin/plugin.json or https://mdapi.io/.well-known/plugin.json
- **Agent Plugins MCP config:** https://mdapi.io/.well-known/plugin/mcp.json
- **Agent Plugins conversion skill:** https://mdapi.io/.well-known/plugin/skills/mdapi-conversion/SKILL.md
- **API documentation pages:** https://mdapi.io/docs
- **Example pages:** https://mdapi.io/docs/examples

## External Links

- **github.com** https://github.com/mdapiio/mdapi.io
- **skills.sh** https://www.skills.sh/mdapiio/mdapi.io
- **skillsmp.com** https://skillsmp.com/creators/mdapiio/mdapi.io
- **clawhub.ai** https://clawhub.ai/mdapiio
- **x.com** https://x.com/mdapiio

## Disclaimer

**The service is provided "AS IS".**


> mdapi.io is an edge-native service-transport primitive for AI, autonomous agents, and the Web4 ecosystem.
