{"_id":"@devspeak/mcp","_rev":"6-cc44b6e90511665a4b0363be9a189c68","name":"@devspeak/mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@devspeak/mcp","version":"1.0.0","_id":"@devspeak/mcp@1.0.0","maintainers":[{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"}],"dist":{"shasum":"486f7336f899777d8e829fb9c1f501d5a4956635","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-hxm1M5JehvFaWW1riQ+Juu9WSvnIunGNYjI6qDVGVmx7GVn/yyOz+VWkZFZgx+wb69TW+C8DbumXLfI4GDCHMw==","signatures":[{"sig":"MEUCIBxuXw+ukKpBpYUdTBZHKViFg0jGtkOvrx/eF3UiBYIMAiEAomjqb8mg1x2UaO8C7uli9+nXoF5l4voLEL37CLjIoVM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26866},"type":"module","gitHead":"18f7d758e8316bb17c6a4662431879c0064f7107","scripts":{"build":"tsc","start":"tsx src/index.ts"},"_npmUser":{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"},"_npmVersion":"11.12.1","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1777248285298_0.9139804117407264","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@devspeak/mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"license":"MIT","_id":"@devspeak/mcp@1.0.1","maintainers":[{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"}],"homepage":"https://www.devspeak.dev","bugs":{"url":"https://github.com/devspeak-dev/devspeak-mcp/issues"},"bin":{"devspeak-mcp":"dist/index.js"},"dist":{"shasum":"9e9c7430032f8e2f358195f75437afd67a10a1af","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-QVxjCIHngHsZ6U//kdhW5ojBuyFs7xG7LLcyawkKgEt5F/FskbhA4cb18lHluX+U2zz8LMuYOTcmS/+1FLIcXQ==","signatures":[{"sig":"MEYCIQDdEsw5riBRB53ncoglshC4xGssHg+4SqbZxYy352jmbAIhAJrlMuYQQnV0nFIheAWXj+wAH1s3W/BEQADUb4Nc0Ese","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24343},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"exports":{".":"./dist/index.js"},"gitHead":"523cb00d1c86cbf37f9e066b22452cce66dfb690","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"},"repository":{"url":"git+https://github.com/devspeak-dev/devspeak-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","@cfworker/json-schema":"^4.1.1","@modelcontextprotocol/server":"2.0.0-alpha.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.1_1777254507302_0.3745690338725183","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@devspeak/mcp","version":"1.0.2","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"license":"MIT","_id":"@devspeak/mcp@1.0.2","maintainers":[{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"}],"homepage":"https://www.devspeak.dev","bugs":{"url":"https://github.com/devspeak-dev/devspeak-mcp/issues"},"bin":{"devspeak-mcp":"dist/index.js"},"dist":{"shasum":"e44d0ff7050d6ce21ec89319af5fb2a3d57ee338","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.0.2.tgz","fileCount":5,"integrity":"sha512-3biIZU4ZOG8GoSzLp8K2aYQyn0vkbTLDA5pA9dTykixSWsLykD4x6zR7QoNh/RkXP/GgQOBCPV9PD4XlO9N/zA==","signatures":[{"sig":"MEYCIQD0MQTDxpyoCmNeelL3trGbbaKlqE6t7tPpT4hhnoIdaQIhAJFGT4GfonU4Een7gIgoYqwX6rVj43syxf+ORR1PQOFO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20472},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"exports":{".":"./dist/index.js"},"gitHead":"523cb00d1c86cbf37f9e066b22452cce66dfb690","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"},"repository":{"url":"git+https://github.com/devspeak-dev/devspeak-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","@cfworker/json-schema":"^4.1.1","@modelcontextprotocol/server":"2.0.0-alpha.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.2_1777254610556_0.5051763459354937","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@devspeak/mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"license":"MIT","_id":"@devspeak/mcp@1.0.3","maintainers":[{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"}],"homepage":"https://www.devspeak.dev","bugs":{"url":"https://github.com/devspeak-dev/devspeak-mcp/issues"},"bin":{"devspeak-mcp":"dist/index.js"},"dist":{"shasum":"9ffa032e4bd49e86eb557f1cf465917b2560982a","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.0.3.tgz","fileCount":5,"integrity":"sha512-QJNF9f712Yc19xQSEPETKzXmzHE1xPq6tdQc76Jf03Kl+uAXCBDdCFEGG49c1+SsLRheLleQjgNgyKW5aVol7g==","signatures":[{"sig":"MEQCIHZ2nQVDXvrDoAfMPPt438d7inMw/tQ+OX/zkTNG+QRvAiAKPda38faDVle7kZuev1J4bU3p5R/RsXIIWr+Zo/ulxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20985},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"exports":{".":"./dist/index.js"},"gitHead":"dfef9e55d70c903187cf67d21008462db47600fa","mcpName":"io.github.juanjaragavi/devspeak","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"juanjaramilloai","email":"info@juanjaramillo.tech"},"repository":{"url":"git+https://github.com/devspeak-dev/devspeak-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","@cfworker/json-schema":"^4.1.1","@modelcontextprotocol/server":"2.0.0-alpha.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.3_1777257916842_0.8017512985919208","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@devspeak/mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"license":"Apache-2.0","_id":"@devspeak/mcp@1.1.0","maintainers":[{"name":"juanjaramilloai","email":"juanamillo@proton.me"}],"homepage":"https://www.devspeak.dev","bugs":{"url":"https://github.com/juanjaragavi/devspeak/issues"},"bin":{"devspeak-mcp":"dist/index.js"},"dist":{"shasum":"e36d926ac9c11c767ac5d58401f25a5433a6f655","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-MtSqCQYTIGbDVmyJjTchu5KrGXCQrNB14/xryPZaKjYPX6lo7yAVNsgsj86cKoxMeRfzh3IpFFbElwMJvYYJlw==","signatures":[{"sig":"MEQCIHo7O4kV0T/DJPeHfH9XqjnWgDCRxSbjxY3ZtY+6taMQAiBL78MBNWGOkl8i7ShjqJvwueO+L0qtWtKTub2ucEpv2g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29346},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"exports":{".":"./dist/index.js"},"gitHead":"de2460f6cfb7d259b85bf8d9666b7251b9eeb287","mcpName":"io.github.juanjaragavi/devspeak","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"juanjaramilloai","email":"juanamillo@proton.me"},"repository":{"url":"git+https://github.com/juanjaragavi/devspeak.git","type":"git","directory":"packages/devspeak-mcp"},"_npmVersion":"10.9.8","description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.3.6","@cfworker/json-schema":"^4.1.1","@modelcontextprotocol/server":"2.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^4.1.11","typescript":"^5.5.0","@types/node":"^22.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1788719087370_0.2594615309175774","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@devspeak/mcp","mcpName":"io.github.juanjaragavi/devspeak","version":"1.2.0","description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"type":"module","main":"dist/index.js","exports":{".":"./dist/index.js"},"bin":{"devspeak-mcp":"dist/index.js"},"scripts":{"start":"node dist/index.js","dev":"tsx src/index.ts","build":"tsc","lint":"tsc --noEmit","test":"vitest run","prepare":"npm run build","prepublishOnly":"npm run build"},"engines":{"node":">=18.0.0"},"license":"Apache-2.0","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/juanjaragavi/devspeak.git","directory":"packages/devspeak-mcp"},"homepage":"https://www.devspeak.dev","bugs":{"url":"https://github.com/juanjaragavi/devspeak/issues"},"dependencies":{"@cfworker/json-schema":"^4.1.1","@modelcontextprotocol/server":"2.0.0","zod":"^4.3.6"},"devDependencies":{"@types/node":"^22.14.0","tsx":"^4.19.0","typescript":"^5.5.0","vitest":"^4.1.11"},"_id":"@devspeak/mcp@1.2.0","gitHead":"757e298c77aff6c79661a3a8b0d2c8bc3860256f","_nodeVersion":"22.23.2","_npmVersion":"10.9.8","dist":{"integrity":"sha512-EitpHYTNPn0yJgB0r4iCMQxUbIhk0gIgNKL/LyExt3Ii+zhGguqLY5RAqEq9vi9K8NYyoZeQk4Ns4a0h0bD3yw==","shasum":"c7f412a486a699d2925d0d091215ea9c8a841380","tarball":"https://registry.npmjs.org/@devspeak/mcp/-/mcp-1.2.0.tgz","fileCount":5,"unpackedSize":32106,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBOcsvxtFAmNy2mAqueqXLg6+meURd8uOvn4RC6Rin4jAiAce0zC4G25QGmEsYU1V4NZeBYngF/U/nAz+PKsBCP7sA=="}]},"_npmUser":{"name":"juanjaramilloai","email":"juanamillo@proton.me"},"directories":{},"maintainers":[{"name":"juanjaramilloai","email":"juanamillo@proton.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.2.0_1788844664691_0.22715658209509093"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-27T00:04:45.192Z","modified":"2026-09-08T05:17:45.001Z","1.0.0":"2026-04-27T00:04:45.449Z","1.0.1":"2026-04-27T01:48:27.458Z","1.0.2":"2026-04-27T01:50:10.702Z","1.0.3":"2026-04-27T02:45:16.985Z","1.1.0":"2026-09-06T18:24:47.501Z","1.2.0":"2026-09-08T05:17:44.818Z"},"bugs":{"url":"https://github.com/juanjaragavi/devspeak/issues"},"license":"Apache-2.0","homepage":"https://www.devspeak.dev","keywords":["mcp","model-context-protocol","devspeak","ai","translation","technical-writing","claude","cursor","windsurf","copilot","specification","technical-translation"],"repository":{"type":"git","url":"git+https://github.com/juanjaragavi/devspeak.git","directory":"packages/devspeak-mcp"},"description":"Official DevSpeak MCP server — translate technical text into formal specs from any AI IDE or agent","maintainers":[{"name":"juanjaramilloai","email":"juanamillo@proton.me"}],"readme":"# @devspeak/mcp\n\nOfficial [DevSpeak](https://www.devspeak.dev) MCP server. Expose DevSpeak's technical translation engine as tools inside any MCP-compatible AI IDE or agent.\n\nDevSpeak converts informal stakeholder requirements into formal, audience-specific technical specifications — Technical Specs, Jira Tickets, API Designs, RFCs, Data Models, and more.\n\n## Tools\n\n| Tool                     | Description                                                   |\n| ------------------------ | ------------------------------------------------------------- |\n| `translate_text`         | Translate informal input into a formal technical spec         |\n| `translate_markdown`     | Translate README / docs while preserving Markdown structure   |\n| `refine_translation`     | Iteratively refine generated output based on feedback         |\n| `optimize_text`          | Stage 1 — polish raw text for grammar, tone, and clarity      |\n| `summarize_input`        | Condense text above the 10,000-character translation limit    |\n| `get_history`            | List previous translations so prior work can be reused        |\n| `get_account_info`       | Report tier, features, and quotas before calling a gated tool |\n| `detect_language`        | Detect the natural language of input text                     |\n| `list_languages`         | Return supported natural languages                            |\n| `auth_confirm`           | Verify API credentials against DevSpeak                       |\n| `patch_translation_note` | Surgically update a note in the DevSpeak Notes Workspace      |\n\n`translate_text`, `translate_markdown`, and `refine_translation` also accept four optional generation flags: `webSearch` (real-time web grounding), `responseFormat` (`markdown` or `xml`), `managedModel` (pin a managed model), and `contextProjectId` (ground on a Context Project).\n\n## Prerequisites\n\n1. A DevSpeak account at [devspeak.dev](https://www.devspeak.dev)\n2. An API key — generate one from **Settings → API Keys** in the DevSpeak dashboard\n3. Node.js 18 or later\n\n---\n\n## Installation by IDE\n\n### Claude Code\n\nAdd to `~/.claude/settings.json` (user-level) or `.claude/settings.json` (project-level):\n\n```json\n{\n  \"mcpServers\": {\n    \"devspeak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\nOr install the server globally and reference it directly:\n\n```bash\nnpm install -g @devspeak/mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"devspeak\": {\n      \"command\": \"devspeak-mcp\",\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"devspeak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nCreate or edit `.cursor/mcp.json` at the project root or `~/.cursor/mcp.json` globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"devspeak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"devspeak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot — Agent Mode)\n\nCreate `.vscode/mcp.json` at the workspace root:\n\n```json\n{\n  \"servers\": {\n    \"devspeak\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n      \"env\": {\n        \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Zed\n\nAdd to Zed's `assistant.json` (accessible via **Zed → Settings → Assistant**):\n\n```json\n{\n  \"context_servers\": {\n    \"devspeak\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n        \"env\": {\n          \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\"\n        }\n      }\n    }\n  }\n}\n```\n\n### Any MCP-compatible host (generic stdio config)\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"-p\", \"@devspeak/mcp\", \"devspeak-mcp\"],\n  \"env\": {\n    \"DEVSPEAK_API_KEY\": \"dsk_live_YOUR_KEY_HERE\",\n    \"DEVSPEAK_API_URL\": \"https://www.devspeak.dev\"\n  }\n}\n```\n\n---\n\n## Environment Variables\n\n| Variable           | Required | Default                    | Description                                     |\n| ------------------ | -------- | -------------------------- | ----------------------------------------------- |\n| `DEVSPEAK_API_KEY` | Yes      | —                          | DevSpeak API key (`dsk_live_…` or `dsk_test_…`) |\n| `DEVSPEAK_API_URL` | No       | `https://www.devspeak.dev` | Override for self-hosted or staging instances   |\n\n---\n\n## Usage Examples\n\nOnce installed, your AI agent can invoke DevSpeak tools directly:\n\n```\nTranslate this rough spec into a formal Technical Spec for a Senior Dev:\n\"users should be able to log in with google and remember their session\"\n```\n\n```\nTranslate the README at the path below for a Junior Dev audience, preserving all Markdown:\n./README.md\n```\n\n```\nRefine the previous output — make it more concise and remove the implementation details section.\n```\n\n---\n\n## Resources\n\nThe server also exposes three read-only resources your agent can fetch:\n\n- `devspeak://supported-languages` — list of supported natural languages\n- `devspeak://api-reference` — DevSpeak API surface summary\n- `devspeak://workflow-reference` — the 3-stage Optimize → Translate → Refine workflow\n\n---\n\n## Agent Skills\n\nFor guided, task-specific workflows (translate a README, translate docs, improve code comments, draft release notes), install the official **DevSpeak Agent Skills**:\n\n- GitHub: [devspeak-dev/devspeak-skills](https://github.com/devspeak-dev/devspeak-skills)\n- skills.sh: search `devspeak`\n\nSkills require this MCP server to be installed and authenticated.\n\n---\n\n## Links\n\n- Platform: [devspeak.dev](https://www.devspeak.dev)\n- CLI: [@devspeak/cli on npm](https://www.npmjs.com/package/@devspeak/cli)\n- VS Code Extension: search **DevSpeak** in the VS Code Marketplace\n- API Reference: [devspeak.dev/docs](https://www.devspeak.dev/docs)\n- Issues: [github.com/juanjaragavi/devspeak/issues](https://github.com/juanjaragavi/devspeak/issues)\n","readmeFilename":"README.md"}