Skip to content

Use Prompy over MCP

Prompy runs a remote Model Context Protocol server at:

https://prompy-app.vercel.app/api/mcp

It uses the Streamable HTTP transport and a personal bearer token.

  1. In Prompy, open avatar menu → API keys.
  2. Name the token after the client you’ll use it in, e.g. Claude Desktop.
  3. Press Create API key and copy it. It starts with prm_ and is shown only once.

The same key also works for the REST API. Revoke a key from the same page at any time. Each token shows when it was last used.

Terminal window
claude mcp add --transport http prompy https://prompy-app.vercel.app/api/mcp \
--header "Authorization: Bearer prm_your_token"

Cursor, Windsurf and other JSON-configured clients

Section titled “Cursor, Windsurf and other JSON-configured clients”
{
"mcpServers": {
"prompy": {
"url": "https://prompy-app.vercel.app/api/mcp",
"headers": { "Authorization": "Bearer prm_your_token" }
}
}
}

Use mcp-remote as a bridge:

{
"mcpServers": {
"prompy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://prompy-app.vercel.app/api/mcp",
"--header", "Authorization: Bearer prm_your_token"]
}
}
}

Ask your assistant things like:

  • “Search my Prompy prompts tagged review.”
  • “Open the Prompy prompt called Tighten a draft and run it on this paragraph.”
  • “Save this system prompt to Prompy with tags support, tone.”
  • “Apply the Prompy design template editorial to this project.” (see Design templates)

See the tool reference for what each tool accepts.

  • A token can read your own prompts, your workspaces’ prompts, public prompts and published design templates, and create new private prompts. It cannot delete or publish anything.
  • Tokens are stored hashed (SHA-256). Prompy can’t show you a token again after it’s created.