# json-promptor-mcp

An MCP server that converts raw text prompts into structured JSON prompts using heuristic keyword extraction — no API keys required.

## Tools

### `convert_prompt_to_json`

Takes a raw text prompt and returns a structured JSON object with extracted fields:

- `purpose` — what the prompt is trying to achieve
- `goal` — the specific desired outcome
- `audience` — who the output is for
- `context` — background information or constraints
- `tone` — desired tone/style (formal, casual, technical, etc.)
- `instructions` — step-by-step directions found in the prompt
- `format` — desired output format (list, paragraph, code, etc.)
- `original_prompt` — the raw input preserved as-is

### `edit_prompt_json`

Takes an existing structured JSON prompt, a field name, and a new value. Returns the updated JSON.

## Build

```bash
npm install
npm run build
```

## MCP Config for Kiro

Add to your `mcp.json`:

```json
{
  "mcpServers": {
    "json-promptor": {
      "command": "node",
      "args": ["json-promptor-mcp/dist/index.js"]
    }
  }
}
```

## Example

Input prompt:
> Write a formal blog post for developers explaining how to use Docker, as a numbered list.

Output:
```json
{
  "purpose": "write a formal blog post for developers explaining how to use docker, as a numbered list",
  "goal": "",
  "audience": "developers",
  "context": "",
  "tone": "formal",
  "instructions": "",
  "format": "numbered list",
  "original_prompt": "Write a formal blog post for developers explaining how to use Docker, as a numbered list."
}
```