Connect Cursor

Piyaz is hosted at app.piyaz.ai. Cursor connects to the hosted MCP endpoint over HTTP and signs in with OAuth on the first tool call. No clone required.

There are two paths. The deeplink gives you the 9 MCP tools on any plan. A Team or Enterprise marketplace adds the workflow skills on top.

cursor://anysphere.cursor-deeplink/mcp/install?name=piyaz&config=eyJ1cmwiOiJodHRwczovL2FwcC5waXlhei5haS9hcGkvbWNwIn0=

https://github.com/FrkAk/piyaz

List my projects.

Self-host

Both install paths above point at the hosted app. To use your own server, start it and register a second entry in ~/.cursor/mcp.json, or %USERPROFILE%\.cursor\mcp.json on Windows. Use .cursor/mcp.json inside a project to scope the server to that project.

The deeplink writes the hosted piyaz entry into this same file, so add your own entry alongside it rather than replacing the file:

{
  "mcpServers": {
    "piyaz": { "url": "https://app.piyaz.ai/api/mcp" },
    "piyaz-self-hosted": { "url": "http://localhost:3000/api/mcp" }
  }
}

Swap http://localhost:3000 for your own origin if you run Piyaz elsewhere, and serve it over HTTPS unless it is on localhost. Restart Cursor afterwards; it runs OAuth on the first tool call against the new server. If you installed through a Team or Enterprise marketplace, leave the mcp.json that ships with the plugin alone, since the next plugin update replaces it. For running the server itself, see the self-host guide.

What gets installed

• The 9 MCP tools that give your agent direct access to the project graph. See the MCP overview.
• On a Team or Enterprise marketplace, the /piyaz skill plus the workflow skills (brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and review).

Next Steps

• MCP Overview -- tool workflows and server instructions.
• Quickstart -- create your first project.

Last updated July 27, 2026