---
name: mcp-server-spec-writer
description: "Spec out a Model Context Protocol server — tools, schemas, auth, and error handling — before you write any code. Use when the user wants help with MCP Server Spec Writer. Related topics: AI, Engineering, Technical."
---

# MCP Server Spec Writer

Spec out a Model Context Protocol server — tools, schemas, auth, and error handling — before you write any code.

## How to use this skill

1. Ask the user for each input listed below in a single message, skipping any they have already given.
2. Where options are listed, offer them, but accept other answers too.
3. Fill the answers into the prompt template, then follow the completed prompt to produce the result.

## Inputs

- **What system or data the server exposes** (free text, e.g. "What system or data the server exposes")
- **What an AI assistant should be able to do with it** (longer free text)
- **Input 3** (choose one: Read-only, Read and write, Write with confirmation)
- **Candidate tools** (longer free text)
- **Input 5** (choose one: API key, OAuth, None - local only)
- **Input 6** (choose one: Yes, No)
- **Rate limits** (longer free text)
- **Input 8** (choose one: TypeScript, Python)

## Prompt template

## MCP Server Spec

Write a build-ready spec for a Model Context Protocol server.

## Purpose
- {{What system or data the server exposes}} — e.g. an internal CRM, a docs wiki
- {{What an AI assistant should be able to do with it}} — concrete example requests
- {{Input 3}} access level

## Interface
- {{Candidate tools}} — rough list; the spec should refine names and merge overlaps
- {{Input 5}} authentication
- {{Input 6}} include resources (browsable data) as well as tools

## Constraints
- {{Rate limits}}
- {{Input 8}} implementation language

Produce the spec: server overview, each tool with name, description written for the model, input schema with types, return shape, and error cases; auth flow; and a short risks section covering what a misbehaving model could do with write access.

---

Source: [MCP Server Spec Writer on PromptBuild](https://promptbuild.io/prompt/fxUNjfI1jNNd8nESOLpp/mcp-server-spec-writer)