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 and library components, so agents reference approved text instead of generating new ones.
  • Create and edit content — projects, project blocks, text items, library components, component folders, variables, and variants — directly from your editor.
  • Manage style guides — create and update style guides and their rules, and inspect workspace tags and statuses, directly from your editor.

​
How it works

The Ditto MCP server runs remotely and exposes tools your AI agent can call, organized around a few areas:
  • Style guides: fetch, create, and update style guides and their rules (get_styleguide_rules, create_styleguide, list_styleguides, update_styleguide, create_styleguide_rules, update_styleguide_rules, delete_styleguide_rules), check text against them (suggest_edit), and look up available tags (get_workspace_tags).
  • Text search: find existing text items and library components by content (search_ditto_text).
  • Projects and blocks: list, create, and organize projects and the blocks within them (list_projects, create_ditto_project, list_project_folders, list_project_blocks, create_project_blocks, update_project_blocks, delete_project_blocks).
  • Text items and library components: create, update, and delete project text and reusable library components (create_text_items, update_text_items, delete_text_items, create_library_components, update_library_components, list_component_folders, create_component_folders, update_component_folders, delete_component_folders).
  • Variables and variants: manage placeholders and locale/tone alternatives (list_variables, create_variables, update_variables, delete_variables, list_variants, create_variants, update_variants, delete_variants).
  • Statuses: look up the statuses text items and library components can be set to (list_statuses).
See the full tool reference for what each tool does and how they fit together. 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.