Quail

This MCP server provides a streamlined way to interact with Quail through MCP clients, enabling you to run locally, connect securely, and perform common actions like authentication, fetching user data, and managing posts from automated workflows.

How to use

You will connect to the Quail MCP server from an MCP client to perform actions such as logging in, retrieving your profile, and managing posts. Use the SSE mode for a straightforward HTTP endpoint you can connect to with any MCP client. Or run the server locally in stdio mode by starting the quail-cli binary directly and feeding commands to it from your MCP-enabled environment. Use the provided URL or local binary as your entry point in your workflow.

How to install

Prerequisites: you need a working Go toolchain for manual installation, or you can download the prebuilt binary for your platform if available.

Install the latest release binary (download and extract to your PATH) to begin using the MCP capabilities.

Install manually using Go: go install github.com/quailyquaily/quail-cli@latest.

Configuration and usage notes

Configuration defaults are stored in your home directory under .config/quail-cli/config.yaml. If the file does not exist, it will be created after the first login.

Set a different configuration path with the --config flag, for example: quail-cli --config /path/to/config.yaml.

To authenticate, run: quail-cli login. Follow the on-screen instructions to complete the OAuth flow.

MCP server configuration

{
  "mcpServers": {
    "quail_sse": {
      "type": "http",
      "name": "quail_sse",
      "url": "http://localhost:8083/sse",
      "args": []
    },
    "quail_stdio": {
      "type": "stdio",
      "name": "quail_stdio",
      "command": "/your_install_path/quail-cli",
      "args": ["mcp"]
    }
  }
}

Tools and capabilities

The server exposes a set of tools that you can invoke through MCP interactions. These include actions to log in, search, retrieve channels and posts, fetch post content, publish/unpublish posts, save posts, and obtain URLs for posts or channels.

Security and data handling

Authenticate securely before accessing user data or making changes. Your access token and related credentials are stored in your configuration and used for subsequent requests. Ensure you protect your local configuration file and rotate tokens as needed.

Troubleshooting

If you encounter connectivity issues, verify that the SSE endpoint is reachable at http://localhost:8083/sse and that your MCP client is pointing to the correct URL. For stdio mode, confirm the exact binary path and the mcp argument is provided to the command you execute.

Notes

This server uses the Quail API at the default base URL https://api.quail.ink unless you override it in the client configuration. You can customize behavior and output format via CLI flags, including --format to choose human or json output.

Available tools

quaily_login

Log in to Quaily to authenticate the user and obtain an access token for subsequent actions.

quaily_search

Search Quaily content based on a query and retrieve matching channels or posts.

quaily_get_my_channels

Fetch all channels owned or accessible to the authenticated user.

quaily_get_channel_posts

Retrieve posts for a specific Quaily channel.

quaily_get_post_content

Get the content of a specific post, including body and metadata.

quaily_get_post

Retrieve a single post by its identifier or slug.

quaily_publish_post

Publish a post to make it publicly visible within the channel.

quaily_unpublish_post

Unpublish a post to remove it from public view without deleting.

quaily_save_post

Save a draft version of a post for later editing or publishing.

quaily_get_url

Obtain the URL for a post or a channel for sharing or embedding.