If you use Cursor, you can connect Piper as a remote MCP server in a couple of minutes. Cursor supports Streamable HTTP MCP servers natively.


1️⃣ Open MCP settings

Open Cursor Settings (Cmd + , on Mac, Ctrl + , on Windows/Linux), then go to Tools & MCP in the sidebar.

2️⃣ Add a new MCP server

Click + Add new MCP server (or Add Custom MCP, depending on your Cursor version). A dialog will appear with fields for the server.

Fill in:

3️⃣ Authenticate & enable

Save the configuration. Cursor will connect to the server and, if prompted, guide you through logging in with your Piper credentials. Once connected, Piper appears under Installed MCP servers with a green status indicator.

💡 If the server doesn't connect, fully quit and reopen Cursor — MCP servers only load at startup.


Editing the config file directly

Prefer config files? Add Piper to your mcp.json instead — ~/.cursor/mcp.json for all projects, or .cursor/mcp.json in a project root:

{
  "mcpServers": {
    "Piper AI": {
      "url": "<https://mcp.piperai.com/mcp>"
    }
  }
}

You're now ready to use Piper AI inside Cursor! 💥