Skip to main content

​
What is the Ditto MCP server?

The Ditto MCP (Model Context Protocol) server connects AI coding agents to your team’s content in Ditto. It gives agents access to your style guide rules and existing text so they can write on-brand text, reuse existing strings, and manage your style guide when generating code. With the MCP server, your AI coding agent can:
  • Follow your style guide rules when writing UI text, so generated copy is consistent with your team’s guidelines.
  • Search and reuse existing text from Ditto projects, so agents reference approved text instead of generating new ones.
  • Create and edit text items — add new strings and update or delete existing ones (text, status, tags, assignee, notes, character limits, and plurals) directly from your editor.
  • Manage style guide rules — create, update, and delete rules and inspect workspace tags directly from your editor.

​
How it works

The Ditto MCP server runs locally and exposes the following tools to any MCP-compatible client:
  1. get_styleguide_rules fetches your workspace and project-level style guide rules from Ditto.
  2. search_ditto_text searches your Ditto projects for existing text items.
  3. create_styleguide_rule adds a new rule to a workspace style guide.
  4. update_styleguide_rule updates an existing style guide rule.
  5. delete_styleguide_rule deletes a style guide rule.
  6. get_workspace_tags lists the tags currently in use across the workspace.
  7. list_projects lists your workspace’s projects with their names and developer IDs.
  8. create_text_items creates new text items in a project.
  9. update_text_items updates existing text items by their developer IDs.
  10. delete_text_items deletes text items by their developer IDs.
Your AI agent calls these tools automatically based on the instructions you provide. For example, you can add a line to your CLAUDE.md or .cursorrules file telling the agent to check Ditto’s style guides before writing any user-facing text. See Example use cases for more.

​
Project configuration

Add a ditto/config.yml or ditto/config.yaml file in your project root to scope MCP tool calls to specific Ditto projects:
When present, the MCP server will automatically include these project IDs in tool calls, so results are scoped to the projects relevant to your codebase.