# GetMarkdown Developer Resources and Agent Integration

GetMarkdown publishes agent-readable product documentation and supports Markdown content negotiation on its homepage.

## Agent resources

- [llms.txt](https://www.getmarkdown.com/llms.txt): Concise when-to-use guidance, limits, workflow selection, and canonical links.
- [llms-full.txt](https://www.getmarkdown.com/llms-full.txt): Expanded product, privacy, package, and troubleshooting reference.
- [Homepage Markdown](https://www.getmarkdown.com/index.md): Direct Markdown representation of the homepage.
- [OpenAPI specification](https://www.getmarkdown.com/openapi.json): Machine-readable contract for the agent surface.
- [Sitemap](https://www.getmarkdown.com/sitemap.xml): Indexed public URL inventory.

Request the homepage Markdown representation with:

```sh
curl -H 'Accept: text/markdown' https://www.getmarkdown.com/
```

The response uses `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept, Accept-Encoding`.

## Agent API surface

GetMarkdown publishes a documented agent surface:

- [OpenAPI specification](https://www.getmarkdown.com/openapi.json): OpenAPI 3.1 document with unique operation IDs, typed parameters, and response schemas for every agent endpoint — suitable for LLM function-calling tools.
- [Agent status](https://www.getmarkdown.com/api/agent/status): JSON capability document listing endpoints, supported formats, and limits.
- [MCP server](https://www.getmarkdown.com/api/mcp): Model Context Protocol server over Streamable HTTP. POST JSON-RPC 2.0 messages (`initialize`, `tools/list`, `tools/call`). Tools: `get_agent_guidance`, `list_supported_formats`, `recommend_workflow`, `get_developer_resources`.
- JSON error contract: unknown `/api/*` paths return HTTP 404 and unsupported methods return 405 as `{ "error": { "code", "message", "hint" } }`.
- Markdown content negotiation: request the homepage with `Accept: text/markdown` or fetch `/index.md`. Unknown paths return a real HTTP 404; Markdown-preferring requests receive the 404 as a Markdown recovery body.

There is no file upload or conversion API. The Advanced PDF backend is a first-party application service, not a public developer API. Agents and integrations must not depend on undocumented service routes.

Use the free browser converter for supported local conversions. Use the Advanced PDF web workflow for one complex PDF that needs stronger table, layout, OCR, or JSON handling. For recurring volume or future integration access, contact GetMarkdown with the file types, expected volume, output requirements, and retention constraints.

- [Developer page](https://www.getmarkdown.com/developers)
- [Contact GetMarkdown](https://www.getmarkdown.com/contact)