📄 README.md

prompts.chat MCP Server

Access thousands of AI prompts directly in your AI coding assistant

Features

MCP Prompts - Browse and use prompts directly via MCP prompts capability
Search Prompts - Search for AI prompts by keyword, category, or tag
Get Prompt - Retrieve prompt details by ID with variable substitution
Variable Support - Prompts with ${variable} syntax are automatically handled

🛠️ Installation

Requirements

Node.js >= v18.0.0
An MCP-compatible client (Cursor, Windsurf, VS Code, Claude Code, etc.)

Install in Cursor

Add this to your Cursor MCP config file (~/.cursor/mcp.json):

Remote Server (Recommended)

{
  "mcpServers": {
    "prompts-chat": {
      "url": "https://prompts.chat/api/mcp"
    }
  }
}

Local Server

{
  "mcpServers": {
    "prompts-chat": {
      "command": "npx",
      "args": ["-y", "@fkadev/prompts.chat-mcp"]
    }
  }
}

Install in Windsurf

Add this to your Windsurf MCP config file:

Remote Server (Recommended)

{
  "mcpServers": {
    "prompts-chat": {
      "serverUrl": "https://prompts.chat/api/mcp"
    }
  }
}

Local Server

{
  "mcpServers": {
    "prompts-chat": {
      "command": "npx",
      "args": ["-y", "@fkadev/prompts.chat-mcp"]
    }
  }
}

Install in VS Code

Add this to your VS Code MCP settings:

Remote Server (Recommended)

"mcp": {
  "servers": {
    "prompts-chat": {
      "type": "http",
      "url": "https://prompts.chat/api/mcp"
    }
  }
}

Local Server

"mcp": {
  "servers": {
    "prompts-chat": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fkadev/prompts.chat-mcp"]
    }
  }
}

Install in Claude Code

Remote Server (Recommended)

claude mcp add --transport http prompts-chat https://prompts.chat/api/mcp

Local Server

claude mcp add prompts-chat -- npx -y @fkadev/prompts.chat-mcp

Install in Zed

Add this to your Zed settings.json:

{
  "context_servers": {
    "prompts-chat": {
      "command": {
        "path": "npx",
        "args": ["-y", "@fkadev/prompts.chat-mcp"]
      }
    }
  }
}

⚙️ Configuration

The local server supports the following environment variables:

Variable	Description
`PROMPTS_API_KEY`	Optional API key for authenticated requests
`PROMPTS_QUERY`	Optional query string to filter prompts (e.g., `users=a,b&categories=c,d&tags=e,f`)

Example with Environment Variables

{
  "mcpServers": {
    "prompts-chat": {
      "command": "npx",
      "args": ["-y", "@fkadev/prompts.chat-mcp"],
      "env": {
        "PROMPTS_API_KEY": "your-api-key",
        "PROMPTS_QUERY": "users=username&categories=coding&tags=productivity"
      }
    }
  }
}

🔨 Available Tools

Tool	Description
`search_prompts`	Search for AI prompts by keyword. Supports filtering by type, category, and tag.
`get_prompt`	Get a prompt by ID. Supports variable elicitation for prompts with template variables.
`save_prompt`	Save a new prompt to your account. Requires `PROMPTS_API_KEY`.

📚 MCP Prompts

This server exposes all public prompts from prompts.chat as MCP prompts. Use prompts/list to browse available prompts and prompts/get to retrieve them with variable substitution.

📖 Example Usage

Ask your AI assistant:

Search for prompts about code review

Get the prompt for "act as a linux terminal"

🔗 Links

prompts.chat - Browse all prompts
API Documentation - API reference
GitHub - Source repository

📄 License

ISC