<p align="center">
  <img src="https://prompts.chat/logo.svg" alt="prompts.chat" width="200" />
</p>

<h1 align="center">prompts.chat MCP Server</h1>

<p align="center">
  Access thousands of AI prompts directly in your AI coding assistant
</p>

<p align="center">
  <a href="https://prompts.chat"><img src="https://img.shields.io/badge/Website-prompts.chat-blue" alt="Website"></a>
  <a href="https://www.npmjs.com/package/@fkadev/prompts.chat-mcp"><img src="https://img.shields.io/npm/v/@fkadev/prompts.chat-mcp?color=red" alt="NPM Version"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@fkadev/prompts.chat-mcp" alt="License"></a>
</p>

---

## 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.)

<details>
<summary><b>Install in Cursor</b></summary>

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

#### Remote Server (Recommended)

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

#### Local Server

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

</details>

<details>
<summary><b>Install in Windsurf</b></summary>

Add this to your Windsurf MCP config file:

#### Remote Server (Recommended)

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

#### Local Server

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

</details>

<details>
<summary><b>Install in VS Code</b></summary>

Add this to your VS Code MCP settings:

#### Remote Server (Recommended)

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

#### Local Server

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

</details>

<details>
<summary><b>Install in Claude Code</b></summary>

#### Remote Server (Recommended)

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

#### Local Server

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

</details>

<details>
<summary><b>Install in Zed</b></summary>

Add this to your Zed `settings.json`:

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

</details>

## ⚙️ 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

```json
{
  "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](https://prompts.chat) - Browse all prompts
- [API Documentation](https://prompts.chat/docs/api) - API reference
- [GitHub](https://github.com/f/prompts.chat) - Source repository

## 📄 License

ISC