Getting started

Requirements

1. Create an API key

API keys can only be created in the prompty.tools dashboard - there is no API for minting keys. Go to prompty.tools/dashboard/api-keys, create a key, and copy it. Keys start with pk_ and are shown once.

2. Register the server in your client

Claude Code

claude mcp add prompty -e PROMPTY_API_KEY=pk_... -- npx -y @prompty-tools/mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config): 

{
  "mcpServers": {
    "prompty": {
      "command": "npx",
      "args": ["-y", "@prompty-tools/mcp"],
      "env": { "PROMPTY_API_KEY": "pk_..." }
    }
  }
}

Cursor

Add the same entry to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "prompty": {
      "command": "npx",
      "args": ["-y", "@prompty-tools/mcp"],
      "env": { "PROMPTY_API_KEY": "pk_..." }
    }
  }
}

3. Verify it works

Restart your client and ask the assistant: "Search prompty for public prompts about code review." You should see a search_prompts tool call with {"scope": "public", "search": "code review"} and a JSON result with items and total.

Configuration reference

Environment variableRequiredDefaultPurpose
PROMPTY_API_KEY yes - Bearer key (pk_...) from the dashboard.
PROMPTY_BASE_URL no https://www.prompty.tools/api/v1 Override for self-hosted or local development setups.
PROMPTY_TIMEOUT_MS no 30000 Per-request HTTP timeout in milliseconds.
Free-tier quota Every tool call is one API request, and the free tier allows 20 requests per day. The server's instructions steer assistants toward targeted searches, but for regular agentic use you will want a pro (1,000/day) or teams (10,000/day) subscription.

Next