juanjaragavi avatar

DevSpeak

io.github.juanjaragavi/devspeak

This server sits between your AI tools and DevSpeak's translation engine to convert informal technical descriptions into formal specifications. It exposes operations that take natural language requirements or architecture notes and turn them into structured technical documents with consistent terminology and format. Reach for it when you're working in Claude or another AI IDE and need to transform rough technical thoughts into polished specs without context switching. The streamable HTTP transport means it works across different environments, not just local setups. Essentially bridges the gap between how developers talk about systems and how those systems need to be documented.

tools
7
auth
Secret needed
transport
STDIO, HTTP
env vars
2
last updated
Oct 24, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

translate_textTranslates and optimizes informal text into formal, audience-specific technical specifications.6 params

Translates and optimizes informal text into formal, audience-specific technical specifications.

Parameters* required
audiencestring
Target audienceone of Junior Dev · Senior Dev · Tech Lead · SRE · Data Engineer
contextstring
Tech contextone of Backend · Frontend · Mobile · Data/ML · DevOps
customInstructionsstring
Optional custom instructions
formatstring
Output formatone of Technical Spec · Jira Tickets · API Design · RFC · Data Model · Prompt
inputstring
Input text (min 10 chars)
tonenumber
Tone (0=Concise, 100=Detailed)
translate_markdownTranslates README and docs content while preserving Markdown structure, links, and code fences.6 params

Translates README and docs content while preserving Markdown structure, links, and code fences.

Parameters* required
audiencestring
Target audienceone of Junior Dev · Senior Dev · Tech Lead · SRE · Data Engineer
contextstring
Tech contextone of Backend · Frontend · Mobile · Data/ML · DevOps
customInstructionsstring
Optional custom instructions
formatstring
Output formatone of Technical Spec · Jira Tickets · API Design · RFC · Data Model · Prompt
inputstring
Input text (min 10 chars)
tonenumber
Tone (0=Concise, 100=Detailed)
refine_translationIteratively refines generated output based on user feedback.8 params

Iteratively refines generated output based on user feedback.

Parameters* required
audiencestring
Target audienceone of Junior Dev · Senior Dev · Tech Lead · SRE · Data Engineer
contextstring
Tech contextone of Backend · Frontend · Mobile · Data/ML · DevOps
feedbackstring
User feedback / changes requested
formatstring
Output formatone of Technical Spec · Jira Tickets · API Design · RFC · Data Model · Prompt
originalInputstring
Original user input
preserveMarkdownboolean
Preserve Markdown structure
previousOutputstring
Previous generated output
tonenumber
Tone (0-100)
detect_languageDetects the primary natural language of the input text.1 params

Detects the primary natural language of the input text.

Parameters* required
inputstring
Text to analyze
list_languagesReturns a list of supported natural languages.

Returns a list of supported natural languages.

No parameter schema in public metadata yet.

auth_confirmVerifies the current API credentials against the DevSpeak backend.

Verifies the current API credentials against the DevSpeak backend.

No parameter schema in public metadata yet.

patch_translation_noteSurgically updates a note in the DevSpeak Notes Workspace by applying replace operations.2 params

Surgically updates a note in the DevSpeak Notes Workspace by applying replace operations.

Parameters* required
noteIdstring
The ID of the note to update
opsarray
List of patch operations to apply

Sponsors

Configuration

DEVSPEAK_API_KEY*secret

DevSpeak API key. Generate one from Settings → API Keys in the DevSpeak dashboard.

DEVSPEAK_API_URL

Optional DevSpeak API base URL override. Leave unset to use https://www.devspeak.dev.

Details

Website
www.devspeak.dev/tutorials/mcp/connect-the-mcp-server
Category
AI & LLM Tools
Package
@devspeak/mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1just-fix avatarJustFix Estimatorjust-fix/justfix-skillQuote UK trades jobs from any AI agent. Price breakdown + tappable booking link.0stars
2juw12 avatarprecedentjuw12/precedentChecks an AI coding agent's "I can't" and "done" claims against evidence.0stars
3kcofoni avatarDuplicati Mcpkcofoni/duplicati-mcpMCP server for Duplicati backup management — list, run, monitor and configure jobs from an LLM.0stars
4kordi-labs avatarKordi — Subscription Intelligencekordi-labs/kordi-mcp-serverTrack, analyze, and act on your streaming and SaaS subscriptions from any AI agent.0stars
5kuzenlabs avatarmaviapikuzenlabs/maviapi-mcpLive JSON from sites with no API (Booking, Airbnb, Tripadvisor…), plus agent-built APIs for any site0stars
6lanbass869-cell avatarCanarilanbass869-cell/canariSigned, offline-verifiable attestations for agent components; ALLOW/BLOCK/REVIEW per install.0stars