DevSpeak

io.github.juanjaragaviPublished by GitHub account juanjaragaviv1.3.1Updated Nov 7, 2026

Improve or correct developer writing, or turn rough notes into technical specs, from your agent.

VerifiedStreamable HTTPWeb executableDeveloper Tools

Overview

AI-generated overview

DevSpeak lets an AI assistant improve or correct developer writing and turn rough notes into technical specs, using the DevSpeak service.

What you can do
Improve or correct developer writing through the DevSpeak service, such as documentation, specs or other technical text, from the assistant. Turn rough notes into structured technical specifications. The manifest lists no individual tools, so the exact operations are not documented here; the server is reached either as a remote endpoint or as a local npm package over stdio.
When to use it
Useful when you want an assistant to polish or fix technical writing, or to convert messy notes into a spec, without leaving the chat. Worth adding if you already use DevSpeak or want its writing service available to your agent.
Requirements
A DevSpeak account and API key, supplied as the DEVSPEAK_API_KEY environment variable for the local package or the x-api-key header for the remote endpoint; the key is created in Settings → API Keys in the DevSpeak dashboard. Network access to the DevSpeak service; DEVSPEAK_API_URL can override the base URL, which otherwise defaults to the DevSpeak site.
Before you install
Requires a secret API key (DEVSPEAK_API_KEY or x-api-key); keep it out of shared configs and logs. Text you submit is sent to the DevSpeak service, so avoid sending confidential or proprietary material unless that is acceptable. The manifest lists no tools, so review what the server can do before relying on it.

Installation

In SourceWeft

  1. Open DevSpeak in the dashboard and add it to a workspace.
  2. Connect x-api-key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.juanjaragavi%2Fdevspeak/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "devspeak": {
      "type": "http",
      "url": "https://www.devspeak.dev/mcp",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

This repository has no README.

Tools

12

translate_text

Translates and optimizes informal text into formal, audience-specific technical specifications. With format "Optimize" it returns the input itself improved, in its own language, instead of a document (set correctionsOnly for corrections only).

ParameterstonerequiredinputrequiredformatrequiredcontextrequiredaudiencerequiredwebSearchmanagedModelresponseFormatcorrectionsOnlycontextProjectIdcustomInstructions

translate_markdown

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

ParameterstonerequiredinputrequiredformatrequiredcontextrequiredaudiencerequiredwebSearchmanagedModelresponseFormatcorrectionsOnlycontextProjectIdcustomInstructions

refine_translation

Iteratively refines generated output based on user feedback.

ParameterstonerequiredformatrequiredcontextrequiredaudiencerequiredfeedbackrequiredwebSearchmanagedModeloriginalInputpreviousOutputrequiredresponseFormatcontextProjectIdpreserveMarkdown

optimize_text

Stage 1 — improves raw text in its own language (grammar, word choice, flow, clarity) without changing meaning or translating it; correctionsOnly limits it to spelling, grammar and punctuation. Use before translate_text when the input is rough.

ParametersinputrequiredcontextrequiredaudiencerequiredmanagedModelcorrectionsOnly

summarize_input

Condenses text that exceeds the 10,000-character translation limit so it can be translated without truncation.

Parametersinputrequired

get_history

Lists the user's previous translations so prior work can be reused instead of regenerated.

Parameterslimitoffset

get_account_info

Returns the account's tier, enabled features, and quotas so an agent can check entitlement before calling a gated tool.

Takes no parameters.

detect_language

Detects the primary natural language of the input text.

Parametersinputrequired

list_languages

Returns a list of supported natural languages.

Takes no parameters.

auth_confirm

Verifies the current API credentials against the DevSpeak backend.

Takes no parameters.

patch_translation_note

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

ParametersopsrequirednoteIdrequired

publish_linkedin_post

Composes a LinkedIn post from a published DevSpeak article. Requires DevSpeak administrator privileges — a standard API key receives 403. Defaults to a preview; pass dryRun:false to publish, which is irreversible.

ParametersslugrequireddryRunlocalecategoryguidancepostTextcontentTyperequired

Version history

4
  1. v1.3.1LatestOct 24, 2026
  2. v1.3.0Oct 19, 2026
  3. v1.2.1Oct 13, 2026
  4. v1.0.3Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.