OpenAPI, Postman and other files
| File | What it is |
|---|---|
| openapi.json | The OpenAPI 3.1 description of the API. This is the one source; the reference is made from the same data. |
| openapi.yaml | The same as YAML. |
| postman-collection.json | A Postman collection with one request per call. Set the variable api_key. |
| llms.txt | A list of all pages for AI assistants. |
| llms-full.txt | All pages in one file. |
| smartchat-docs.zip | All pages as Markdown plus the OpenAPI files. |
| sitemap.xml | All pages. |
Every page is also available as Markdown: add .md to its address, or use the link at the bottom of the page.
#Use OpenAPI to make a client
Any OpenAPI 3.1 generator can make a client from openapi.json. Each call has an operationId that equals the name used in this reference. The MCP server uses the same name for most tools; where it differs (for example save_contact for create_contact and update_contact), the name is in x-mcp-tool and in the column REST operationId of the tool list. Extra fields starting with x- describe the permission (x-scope), the risk (x-risk), the effects (x-effects) and the MCP tool (x-mcp-tool).