prompts.chat MCP Server — Claude Code MCP server: guide
Connects community prompt libraries to your AI editor. Lets you query role instructions, populate template variables, and store your own prompts.
claude mcp add --env PROMPTS_API_KEY=<PROMPTS_API_KEY> --env PROMPTS_QUERY=<PROMPTS_QUERY> --transport stdio promptschat-mcp-server -- npx -y @fkadev/prompts.chat-mcpWhat prompts.chat MCP Server does
This server connects your editor to the prompts.chat platform using the Model Context Protocol. It exposes three core tools: search_prompts to filter items by keyword or topic, get_prompt to retrieve text with dynamic variable substitution, and save_prompt to publish new entries. Prompts containing ${variable} syntax get populated automatically before use.
You can run the server locally with npx or point your client directly to https://prompts.chat/api/mcp. Local execution requires Node.js 18.0.0 or higher. You can also scope search results ahead of time by passing custom tags or user handles into the PROMPTS_QUERY environment variable.
Reading public instructions requires no account credentials. However, the save_prompt tool will reject any write attempts without a configured PROMPTS_API_KEY.
What it helps with
- Find specific role-play prompts without leaving your editor
- Retrieve prompt templates and populate dynamic placeholders automatically
- Save tested engineering prompts directly to a personal account
- Filter prompt recommendations by creator handles or domain tags
Example prompts for the agent
- Search prompts.chat for code review guidelines
- Fetch the prompt for a terminal assistant and populate its arguments
- Save my current SQL refactoring instructions to my prompts.chat profile
How to install prompts.chat MCP Server
Platform CLI
claude mcp add --env PROMPTS_API_KEY=<PROMPTS_API_KEY> --env PROMPTS_QUERY=<PROMPTS_QUERY> --transport stdio promptschat-mcp-server -- npx -y @fkadev/prompts.chat-mcpReplace <…> with your own values
Platform CLI
codex mcp add promptschat-mcp-server --env PROMPTS_API_KEY=<PROMPTS_API_KEY> --env PROMPTS_QUERY=<PROMPTS_QUERY> -- npx -y @fkadev/prompts.chat-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"promptschat-mcp-server": {
"command": "npx",
"args": [
"-y",
"@fkadev/prompts.chat-mcp"
],
"env": {
"PROMPTS_API_KEY": "<PROMPTS_API_KEY>",
"PROMPTS_QUERY": "<PROMPTS_QUERY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"promptschat-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@fkadev/prompts.chat-mcp"
],
"env": {
"PROMPTS_API_KEY": "<PROMPTS_API_KEY>",
"PROMPTS_QUERY": "<PROMPTS_QUERY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PROMPTS_API_KEY=<PROMPTS_API_KEY> -e PROMPTS_QUERY=<PROMPTS_QUERY> promptschat-mcp-server npx -y @fkadev/prompts.chat-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about prompts.chat MCP Server
How to install prompts.chat MCP Server in Claude Code?
Run claude mcp add prompts-chat-mcp -e PROMPTS_API_KEY=<PROMPTS_API_KEY> -- npx -y @fkadev/prompts.chat-mcp in your terminal. Replace the placeholder with your token, or drop the flag if you only intend to search.
What does prompts.chat MCP Server do?
It lets your coding assistant search, read, and use community prompts from prompts.chat. It also handles placeholder substitution so you can insert parameterized templates into the session.
Do you need an API key to search prompts?
Public prompt discovery and variable retrieval work without credentials. The PROMPTS_API_KEY variable is only required if you use save_prompt to store new templates in your profile.
