Cutline

Tool Reference

Complete reference for all Cutline MCP tools and their parameters.

MCP Tool Reference

Complete documentation for all Cutline MCP tools available through the Model Context Protocol.

Pre-mortem Tools

These tools are available through the cutline-premortem server.

premortem.run

Generate a complete pre-mortem analysis synchronously.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | input | object | Yes | Pre-mortem input configuration | | input.productName | string | Yes | Name of the product or feature | | input.productDescription | string | Yes | 2-3 sentence description | | input.referenceClasses | string[] | No | Industry/domain references | | input.pessimism | number | No | Pessimism level (0.0 - 1.0, default: 0.5) | | auth_token | string | No | Firebase ID token (auto-filled by CLI) |

Example:

{
  "input": {
    "productName": "Mobile Analytics Dashboard",
    "productDescription": "A mobile app that provides real-time analytics for e-commerce stores, helping merchants track sales and customer behavior on the go.",
    "referenceClasses": ["Mobile apps", "Analytics tools", "E-commerce"],
    "pessimism": 0.6
  }
}

Response: Full pre-mortem document with assumptions, risks, experiments, and recommendations.

premortem.list

List all pre-mortems for the authenticated user.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | limit | number | No | Maximum results (default: 10) | | auth_token | string | No | Firebase ID token |

Example:

{
  "limit": 5
}

Response: Array of pre-mortem summaries with IDs, names, status, and dates.

premortem.queue

Queue an asynchronous pre-mortem job for longer/complex analyses.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | input | object | Yes | Same as premortem.run | | auth_token | string | No | Firebase ID token |

Response: Job ID for tracking progress.

premortem.status

Check the status of a queued pre-mortem job.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | jobId | string | Yes | Job ID from premortem.queue | | auth_token | string | No | Firebase ID token |

Response: Job status, progress percentage, and current stage.

premortem.kick

Execute or resume a queued pre-mortem job.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | jobId | string | Yes | Job ID to execute | | auth_token | string | No | Firebase ID token |

premortem.regen_assumptions

Regenerate the assumptions section of an existing pre-mortem.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | input | object | Yes | Original input parameters | | doc | object | Yes | Existing pre-mortem document | | auth_token | string | No | Firebase ID token |

premortem.regen_experiments

Regenerate the experiments section of an existing pre-mortem.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | input | object | Yes | Original input parameters | | doc | object | Yes | Existing pre-mortem document | | auth_token | string | No | Firebase ID token |

Persona Tools

These tools are available through the cutline-tools server.

personas.list

List all personas for the authenticated user.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | productId | string | No | Filter by product ID | | auth_token | string | Yes | Firebase ID token |

Response: Array of persona objects with demographics, personality, and behaviors.

personas.get

Get a specific persona by ID.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | personaId | string | Yes | Persona ID | | auth_token | string | Yes | Firebase ID token |

Response: Complete persona object.

personas.chat

Have a conversation with a persona about your product or feature.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | persona | object | Yes | Persona object | | userMessage | string | Yes | Your message to the persona | | conversationHistory | array | No | Previous messages for context | | product | object | No | Product context | | auth_token | string | Yes | Firebase ID token |

Example:

{
  "persona": {
    "name": "Debra",
    "description": "Technical solopreneur running multiple SaaS businesses",
    "role": "Founder",
    "segment": "Startup"
  },
  "userMessage": "What do you think about adding a mobile app to our analytics platform?",
  "product": {
    "name": "Cutline",
    "brief": "AI product management suite"
  }
}

Response: Persona's response in character, based on their profile.

Wiki Tools

These tools are available through the cutline-tools server.

wiki.load

Load the wiki/documentation for a project.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | projectId | string | Yes | Project ID | | auth_token | string | No | Firebase ID token |

Response: Wiki content in markdown format.

wiki.save

Save updated wiki content.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | projectId | string | Yes | Project ID | | markdown | string | Yes | Wiki content in markdown | | auth_token | string | No | Firebase ID token |

wiki.apply_edits

Apply specific edits to wiki content.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | edits | array | Yes | Array of edit operations | | auth_token | string | No | Firebase ID token |

Agent Tools

agent.chat

Chat with the Cutline AI assistant about your wiki or product.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Your question or request | | wikiMarkdown | string | No | Wiki context for the chat | | auth_token | string | No | Firebase ID token |

Example:

{
  "prompt": "What are the main risks identified in my product wiki?",
  "wikiMarkdown": "# My Product\n\n## Risks\n- Market timing..."
}

trial.generate

Generate a trial run scenario for testing.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Description of what to test |

Example:

{
  "prompt": "Generate a trial run for testing our checkout flow with 100 users"
}

Output Tools

These tools are available through the cutline-output server.

premortem.render_pdf

Generate a PDF from a pre-mortem document.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | doc | object | Yes | Pre-mortem document | | store | boolean | No | Store PDF in cloud (default: false) | | auth_token | string | No | Firebase ID token |

Response: Signed URL to download the PDF.

premortem.qa_answer

Answer questions about a pre-mortem document.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | doc | object | Yes | Pre-mortem document | | question | string | Yes | Question to answer |

Example:

{
  "doc": { ... },
  "question": "What are the top 3 risks identified?"
}

Integration Tools

These tools are available through the cutline-integrations server.

integrations.create_issues

Create issues in an external issue tracker from pre-mortem results.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | schema_json | object | Yes | Issue schema and data | | limit | number | No | Maximum issues to create | | auth_token | string | No | Firebase ID token |

Error Handling

All tools may return errors in this format:

{
  "error": "MCP error -32600: Permission denied"
}

Common Error Codes:

| Code | Meaning | Solution | |------|---------|----------| | -32600 | Permission denied | Check authentication | | -32601 | Method not found | Verify tool name | | -32602 | Invalid params | Check required parameters | | -32603 | Internal error | Contact support |

Rate Limits

| Tier | Requests/minute | Pre-mortems/month | |------|-----------------|-------------------| | Premium | 60 | Unlimited | | Enterprise | 120 | Unlimited |

Next Steps

MCP Setup Guide
MCP Examples