Straker Verify MCP

Overview

This project is a local MCP (Model Context Protocol) server that exposes Straker Verify translation tools. Running it lets you automate project creation, confirmation, and file download entirely on your own machine.

Getting your Verify API key

1. Log in to the Straker Verify dashboard (https://verify.straker.ai). If you’re new to the platform see the official Getting started guide. (docs)
2. Navigate to Settings → API Keys (direct link in the Verify UI) — see the API-key docs here.
3. Press Create New Key, give it a descriptive name (e.g. "Local MCP"), and save.
4. Copy the generated key once and set it as an environment variable before starting the server:

Integration

Cursor

Add to ~/.cursor/mcp.json:

{
 "mcpServers": {
  "straker-verify": {
   "command": "npx",
   "args": ["-y", "@strakergroup/straker-verify-mcp"],
   "env": {
    "VERIFY_API_KEY": "<YOUR VERIFY API KEY>"
   }
  }
 }
}

VS Code

Create .vscode/mcp.json:

{
 "servers": {
  "straker-verify": {
   "command": "npx",
   "args": ["-y", "@strakergroup/straker-verify-mcp"],
   "env": {
    "VERIFY_API_KEY": "<YOUR VERIFY API KEY>"
   }
  }
 }
}

Claude Desktop

Add to claude_desktop_config.json:

{
 "mcpServers": {
  "straker-verify": {
   "command": "npx",
   "args": ["-y", "@strakergroup/straker-verify-mcp"],
   "env": {
    "VERIFY_API_KEY": "<YOUR VERIFY API KEY>"
   }
  }
 }
}

Filesystem MCP Server (local file tools)

Filesystem MCP Server gives Claude Desktop safe, approval-based access to read/write, move/rename, and search files in specific directories you allow.

Add to claude_desktop_config.json:

{
 "mcpServers": {
  "filesystem": {
   "command": "npx",
   "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "/absolute/path/you/want/to/allow",
    "/another/allowed/path"
   ]
  }
 }
}

You can test it manually from a terminal:

npx -y @modelcontextprotocol/server-filesystem /absolute/path/you/want/to/allow /another/allowed/path

Notes:

• Replace the example paths with directories you want Claude to access.
• Requires Node.js. Only grant access to folders you trust; Claude will request approval before any file operations.

Available Tools

These MCP tools wrap the Straker Verify API and are available to Desktop clients:

• get_token_balance – returns your current Verify token balance.
• get_languages – lists languages supported by Verify.
• get_workflows – lists available Straker Orchestrate workflows.
• create_project_from_paths – creates a Verify project from one or more local file paths.
• get_project – fetches full details for a project by ID.
• get_projects – lists your recent projects (paginated).
• confirm_project – confirms a project once it is ready (spends tokens).
• download_project_files – downloads all completed translations into a local directory.

How to use

Once configured in your MCP client (Cursor, VS Code MCP, or Claude Desktop):

1. Check readiness and discover IDs

• Ask: “What is my Verify token balance?” → calls get_token_balance
• Ask: “List target languages with IDs” → calls get_languages (use the id values as languageIds)
• Ask: “List available workflows with IDs” → calls get_workflows (use the workflow id)
• Ask: “Search the Verify docs for topic” → calls help_search with { "query": "topic" }

2. Create a project from local files

• Ensure the files exist on your machine. You can provide absolute paths directly, or use a Filesystem MCP server to help pick files.

• Ask: “Create a Verify project titled ‘Website Strings’ from these files and languages, using this workflow.” Example arguments used by the tool:

  {
   "title": "Website Strings",
   "filePaths": ["/abs/path/messages.json", "/abs/path/emails.txt"],
   "languageIds": ["<language-uuid-1>", "<language-uuid-2>"],
   "workflowId": "<workflow-uuid>",
   "client_notes": "Created via MCP"
  }

3. Inspect project status/details

• Ask: “List my recent projects (page 1, 10 per page)” → calls get_projects with:

  {
    "page": 1,
    "page_size": 10
  }

• Ask: “Show project details for projectId” → calls get_project

4. Confirm and download results

• Before confirming: ensure your balance covers token_cost (shown in get_project). Confirming spends tokens.

• Confirm only (useful if you want to wait to download later or retry just the download step):

  {
    "projectId": "<project-uuid>",
    "pollIntervalSeconds": 5,
    "timeoutSeconds": 600
  }

  Call tool: confirm_project

• Download only (works for already-confirmed or already-completed projects):

  {
    "projectId": "<project-uuid>",
    "outputDir": "/abs/path/output",
    "pollIntervalSeconds": 5,
    "timeoutSeconds": 600
  }

  Call tool: download_project_files

Tip: For file picking and browsing, consider enabling the Filesystem MCP Server (see section above). It helps the assistant enumerate and validate local paths you want to include.

• help_search – searches the Straker Verify Help Center and returns the most relevant article (title, excerpt, URL).