prompts.chat MCP Server

Search for AI prompts by keyword. Returns matching prompts with title, description, content, author, category, and tags. Use this to discover prompts for various AI tasks like coding, writing, analysis, and more.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query to find relevant prompts",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of prompts to return (default 10, max 50)",
      "default": 10,
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "type": {
      "description": "Filter by prompt type",
      "type": "string",
      "enum": [
        "TEXT",
        "STRUCTURED",
        "IMAGE",
        "VIDEO",
        "AUDIO"
      ]
    },
    "category": {
      "description": "Filter by category slug",
      "type": "string"
    },
    "tag": {
      "description": "Filter by tag slug",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a prompt by ID and optionally fill in its variables. If the prompt contains template variables (like {{variable}}), you will be asked to provide values for them.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "The ID of the prompt to retrieve",
      "type": "string"
    },
    "fill_variables": {
      "description": "If true and the prompt has template variables, triggers interactive variable filling. Default false — returns raw prompt with variable metadata.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Save a new prompt to your prompts.chat account. Requires API key authentication. Prompts are private by default unless configured otherwise in settings.

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Title of the prompt",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "content": {
      "description": "The prompt content. Can include variables like ${variable} or ${variable:default}",
      "type": "string",
      "minLength": 1
    },
    "description": {
      "description": "Optional description of the prompt",
      "type": "string",
      "maxLength": 500
    },
    "tags": {
      "description": "Optional array of tag names (will be created if they don't exist)",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "category": {
      "description": "Optional category slug",
      "type": "string"
    },
    "isPrivate": {
      "description": "Whether the prompt is private (default: uses your account setting)",
      "type": "boolean"
    },
    "type": {
      "description": "Prompt type (default: TEXT)",
      "type": "string",
      "enum": [
        "TEXT",
        "STRUCTURED",
        "IMAGE",
        "VIDEO",
        "AUDIO"
      ]
    },
    "structuredFormat": {
      "description": "Format for structured prompts",
      "type": "string",
      "enum": [
        "JSON",
        "YAML"
      ]
    }
  },
  "required": [
    "title",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Transform a basic prompt into a well-structured, comprehensive prompt using AI. Optionally searches for similar prompts for inspiration. Supports different output types (text, image, video, sound) and formats (text, JSON, YAML).

{
  "type": "object",
  "properties": {
    "prompt": {
      "description": "The prompt to improve",
      "type": "string",
      "minLength": 1,
      "maxLength": 10000
    },
    "outputType": {
      "description": "Content type: text, image, video, or sound",
      "default": "text",
      "type": "string",
      "enum": [
        "text",
        "image",
        "video",
        "sound"
      ]
    },
    "outputFormat": {
      "description": "Response format: text, structured_json, or structured_yaml",
      "default": "text",
      "type": "string",
      "enum": [
        "text",
        "structured_json",
        "structured_yaml"
      ]
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Save a new Agent Skill to your prompts.chat account. Skills are multi-file prompts that can include SKILL.md (required), reference docs, scripts, and configuration files. Requires API key authentication. If the file contents are too long, first save the SKILL.md only, with no other files. Then call add_file_to_skill tool per file.

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Title of the skill",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "description": {
      "description": "Description of what the skill does",
      "type": "string",
      "maxLength": 500
    },
    "files": {
      "description": "Array of files. Must include SKILL.md as the main skill file.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "filename": {
            "description": "File path (e.g., 'SKILL.md', 'reference.md', 'scripts/helper.py')",
            "type": "string"
          },
          "content": {
            "description": "File content",
            "type": "string"
          }
        },
        "required": [
          "filename",
          "content"
        ]
      }
    },
    "tags": {
      "description": "Optional array of tag names",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "category": {
      "description": "Optional category slug",
      "type": "string"
    },
    "isPrivate": {
      "description": "Whether the skill is private (default: uses your account setting)",
      "type": "boolean"
    }
  },
  "required": [
    "title",
    "files"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add a new file to an existing Agent Skill. Use this to add reference docs, scripts, or configuration files to a skill you own.

{
  "type": "object",
  "properties": {
    "skillId": {
      "description": "The ID of the skill to add the file to",
      "type": "string"
    },
    "filename": {
      "description": "File path (e.g., 'reference.md', 'scripts/helper.py', 'config/settings.json')",
      "type": "string"
    },
    "content": {
      "description": "File content",
      "type": "string"
    }
  },
  "required": [
    "skillId",
    "filename",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Update an existing file in an Agent Skill. Use this to modify reference docs, scripts, configuration files, or SKILL.md content.

{
  "type": "object",
  "properties": {
    "skillId": {
      "description": "The ID of the skill containing the file",
      "type": "string"
    },
    "filename": {
      "description": "File path to update (e.g., 'SKILL.md', 'reference.md', 'scripts/helper.py')",
      "type": "string"
    },
    "content": {
      "description": "New file content",
      "type": "string"
    }
  },
  "required": [
    "skillId",
    "filename",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Remove a file from an existing Agent Skill. Cannot remove SKILL.md as it is required.

{
  "type": "object",
  "properties": {
    "skillId": {
      "description": "The ID of the skill to remove the file from",
      "type": "string"
    },
    "filename": {
      "description": "File path to remove (e.g., 'reference.md', 'scripts/helper.py')",
      "type": "string"
    }
  },
  "required": [
    "skillId",
    "filename"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get an Agent Skill by ID, including all its files (SKILL.md, reference docs, scripts, etc.). Returns the skill metadata and file contents. Save to .claude/skills/{slug}/SKILL.md and .claude/skills/{slug}/[other files] structure if user asks to download.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "The ID of the skill to retrieve",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search for Agent Skills by keyword. Returns matching skills with title, description, author, and file list. Use this to discover reusable AI agent capabilities for coding, analysis, automation, and more.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query to find relevant skills",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of skills to return (default 10, max 50)",
      "default": 10,
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "category": {
      "description": "Filter by category slug",
      "type": "string"
    },
    "tag": {
      "description": "Filter by tag slug",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}