Yak

You set up a chatty MCP server that lets coding agents talk back to you through speech. It provides a simple HTTP endpoint that agents can connect to, receive spoken responses, and perform actions within your coding workflow.

How to use

Connect your coding agent to the MCP server by pointing it at the server URL and then start your agent. If you run the server on a machine that your agent can reach, use the server’s host and port. For example, if you are running the MCP server on your local machine and want to access it from a devcontainer, bind the server to 0.0.0.0 so the container can reach it. Once connected, you can issue voice-enabled instructions to your agent and have it respond aloud.

How to install

Prerequisites: None specific beyond having access to platform installers. Obtain the platform-specific installer compatible with your OS from the release channel.

Install on Windows or Linux by running the installer you downloaded. The installer will guide you through the initial setup and start the MCP server once configured.

macOS users: If you need a macOS installer but it isn’t available for your environment, you can build it yourself using the provided build instructions. After building, run the installer to complete the setup.

After installation, launch the application to open the settings screen. You will configure the MCP Server, TTS, and then save your settings to start the server.

Additional notes

MCP server configuration enables an HTTP-based connection for client agents. Use the following configuration snippet to connect your coding agent to the MCP server. The port and host you choose must match what you configure in the server settings.

"yak": {
  "type": "http",
  "url": "http://localhost:8080/mcp"
}

Testing

After you finish setup, start your coding agent and run the following instruction to verify the integration works and the agent speaks back to you.

use yak, say "Hello."