promptz.dev MCP Server

@cremich

About promptz.dev MCP Server

MCP Server implementation for promptz.dev

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "promptz.dev": {
      "command": "npx",
      "args": [
        "-y",
        "@promptz/mcp"
      ],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Tools

List available prompts from promptz.dev

Get a specific prompt by ID or name

List available project rules from promptz.dev

Get a specific project rule by name

Overview

What is promptz.dev MCP Server?

A Model Context Protocol (MCP) server that exposes prompts and project rules from the promptz.dev API directly inside Amazon Q Developer, eliminating the need to copy-paste and reducing context switching.

How to use promptz.dev MCP Server?

Obtain API credentials from promptz.dev/mcp, then add the server configuration to your Amazon Q Developer MCP client settings file (~/.aws/amazonq/mcp.json) using either npx (recommended) or a local installation. Once connected, you can search and execute prompts or manage project rules via natural language in Amazon Q Developer.

Key features of promptz.dev MCP Server

Search and execute prompts from promptz.dev.
Search for project rules from promptz.dev.
Integrate with other tools to add or update rules in your workspace.
Operates as a read‑only MCP server (no write operations).
Communicates with the promptz.dev API over HTTPS.
Logs to a local file at ~/.promptz/logs/mcp-server.log.

Use cases of promptz.dev MCP Server

Quickly retrieve and apply a documentation prompt while working in Amazon Q Developer.
Find and add project rules for a specific stack (e.g., CDK Development) to your workspace.
Use natural language commands to search prompts without leaving your IDE.
Integrate promptz.dev’s prompt library into an existing MCP‑compatible workflow.

FAQ from promptz.dev MCP Server

How do I install the server?

You can use npx (recommended) by adding a configuration snippet to ~/.aws/amazonq/mcp.json, or clone the repository, install dependencies (npm install), build (npm run build), and reference the built index.js.

Where do I get API credentials?

Go to promptz.dev/mcp and copy the MCP settings, including your API Key and API URL.

What can I do with this server?

You can search and execute prompts, search for project rules, and (with compatible tools) add or update those rules in your workspace.

What if something goes wrong?

Check that your API credentials are correct, ensure the server configuration is valid, and look for error messages in the logs at ~/.promptz/logs/mcp-server.log. You can also use the MCP Inspector for debugging.

Is the server read‑only?

Yes, the server only provides read access to prompts and project rules; it does not implement any write operations.

Frequently asked questions

How do I install the server?

You can use npx (recommended) by adding a configuration snippet to `~/.aws/amazonq/mcp.json`, or clone the repository, install dependencies (`npm install`), build (`npm run build`), and reference the built `index.js`.

Where do I get API credentials?

Go to [promptz.dev/mcp](https://promptz.dev/mcp) and copy the MCP settings, including your API Key and API URL.

What can I do with this server?

You can search and execute prompts, search for project rules, and (with compatible tools) add or update those rules in your workspace.

What if something goes wrong?

Check that your API credentials are correct, ensure the server configuration is valid, and look for error messages in the logs at `~/.promptz/logs/mcp-server.log`. You can also use the MCP Inspector for debugging.