Connect Cursor
Connect Piyaz in Cursor over the hosted MCP endpoint, or install the skills via a Team marketplace.
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 6 MCP tools on any plan. A Team or Enterprise marketplace adds the workflow skills on top.
Open the install deeplink, then sign in on the first tool call:
cursor://anysphere.cursor-deeplink/mcp/install?name=piyaz&config=eyJ1cmwiOiJodHRwczovL2FwcC5waXlhei5haS9hcGkvbWNwIn0=The deeplink registers an MCP server pointing at https://app.piyaz.ai/api/mcp. Cursor runs OAuth on the first tool call.
Team Marketplaces is a Teams/Enterprise feature. In the dashboard, go to Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo, then paste:
https://github.com/FrkAk/piyazThis installs the workflow skills alongside the MCP tools.
Listing in the public Cursor Marketplace requires submission and manual review. Search-and-install lands once Piyaz is published there.
Verify
Open a new Composer session (Cmd/Ctrl+I) and ask:
List my projects.Cursor returns your project list. An empty list is expected on a fresh account.
Self-host
To run Piyaz on your own infrastructure, start the server locally and edit Cursor's mcp.json to point the piyaz server at http://localhost:3000/api/mcp. Cursor reads a hardcoded hosted URL, so for a custom domain edit the mcp.json directly. For running the server itself, see the self-host guide.
What gets installed
- The 6 MCP tools:
piyaz_project,piyaz_task,piyaz_edge,piyaz_query,piyaz_context,piyaz_analyze. - On a Team or Enterprise marketplace, the
/piyazskill plus the workflow skills (brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and review).
composer (end-to-end task orchestration) is Claude Code only for now. For that flow, use Claude Code.
Next Steps
- MCP Overview -- tool workflows and server instructions.
- Quickstart -- create your first project.