# DevSpeak

DevSpeak bridges the gap between product and engineering. Powered by Gemini AI, it instantly translates ambiguous stakeholder requirements into structured technical specs, Jira tickets, and API desig…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add juanamillo-1duz/devspeak

# Browse available tools
npx -y @smithery/cli@latest tool list juanamillo-1duz/devspeak

# Get full schema for a tool
npx -y @smithery/cli@latest tool get juanamillo-1duz/devspeak translate_text

# Call a tool
npx -y @smithery/cli@latest tool call juanamillo-1duz/devspeak translate_text '{}'
```

## Direct MCP Connection

Endpoint: `https://devspeak--juanamillo-1duz.run.tools`

**Required config:**
- `x-api-key` (header) — Your DevSpeak API key. Generate one from Settings → API Keys at devspeak.dev.

## Tools (7)

- `translate_text` — Translates and optimizes informal text into formal, audience-specific technical specifications.
- `translate_markdown` — Translates README and docs content while preserving Markdown structure, links, and code fences.
- `refine_translation` — Iteratively refines generated output based on user feedback.
- `detect_language` — Detects the primary natural language of the input text.
- `list_languages` — Returns a list of supported natural languages.
- `auth_confirm` — Verifies the current API credentials against the DevSpeak backend.
- `patch_translation_note` — Surgically updates a note in the DevSpeak Notes Workspace by applying replace operations.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get juanamillo-1duz/devspeak <tool-name>
```

## Resources

- `devspeak://supported-languages` — List of supported natural languages
- `devspeak://api-reference` — Summary of the DevSpeak API capabilities
- `devspeak://workflow-reference` — Summary of the 3-stage DevSpeak workflow