Skip to main content
Pretty exposes these tools at https://api.make-pretty.com/mcp. Your MCP client discovers their full input schemas with tools/list after OAuth sign-in. Access is limited to your account and the Pretty workspace selected during authorization.

​
Chat status

get_chat_status returns one of five values: send_message defaults to queued: true: when Pretty is working, the new message waits for the current turn. Set queued: false to stop that turn and run the new message next. The partial reply remains in the chat.

​
Attachments

Both message tools accept an attachments array. Use the paths returned by list_files:
The Workspace path must be readable by your Pretty account. A link must be a valid URL; title is optional. This connection does not accept file bytes or upload local files.

​
Pagination

list_messages returns newest messages first unless you set order: "oldest". Its limit defaults to 50 and accepts 1 to 100. list_chats defaults to 25 and also accepts 1 to 100. Pass nextCursor into the next call as cursor; keep the same message order while paging. list_files shows the organization and personal roots when path is omitted. Pass a returned directory path to list that folder, then use nextCursor to continue if there are more entries.

​
Authentication

Pretty uses OAuth with the mcp:tools scope. The endpoint requires an access token for https://api.make-pretty.com/mcp; it checks workspace membership and external access on requests. Authorization discovery is available at /.well-known/oauth-protected-resource/mcp.