AI Integration

RIDDL MCP Server

Connect AI assistants like Claude to your RIDDL workflow via the Model Context Protocol. Generate, validate, and refine domain models with AI assistance.

Documentation View Plans

What is the Model Context Protocol?

MCP is an open protocol that allows AI assistants to access external tools and data sources. The RIDDL MCP Server gives AI assistants like Claude direct access to RIDDL's validation, analysis, and generation capabilities.

This means you can have natural language conversations about your domain model while the AI has real-time access to validate syntax, check completeness, suggest improvements, and generate code.

13 Specialized Tools

The MCP Server exposes tools that give AI assistants deep understanding of RIDDL syntax, semantics, and best practices.

Validation

  • validate-text
  • validate-url
  • validate-partial

Analysis

  • check-completeness
  • check-simulability
  • map-domain-to-riddl
  • explain-error

Guidance

  • suggest-next
  • expand-pattern

Template

  • list-patterns
  • list-templates
  • get-template
  • generate-test-cases

Built-in Knowledge

The MCP Server includes comprehensive RIDDL documentation as resources that AI assistants can access. This means the AI understands RIDDL deeply - not just syntax, but patterns, idioms, and best practices.

When you ask the AI for help, it draws on this knowledge to provide accurate, contextual assistance specific to RIDDL.

The result: richer, more accurate, more complete models so your design intent transmits faithfully to human audiences and AI implementers alike.

Available Resources

  • EBNF Grammar
  • Language Guide
  • Cheat Sheet
  • Patterns Catalog
  • Idioms Reference
  • Anti-Patterns Guide
  • Example Models

What Can You Do?

💬

Natural Language Modeling

Describe your domain in plain English. The AI translates it to valid RIDDL.

✅

Real-Time Validation

Get instant feedback on syntax errors, missing references, and semantic issues.

🔍

Error Explanation

Don't understand an error? Ask the AI to explain it and suggest fixes.

🧩

Patterns & Idioms

Apply proven DDD patterns and RIDDL idioms to your domain with AI guidance.

Quick Setup

1

Install Claude Desktop or Claude Code

2

Add this to your Claude configuration file:

Claude Desktop Configuration

{
  "mcpServers": {
    "riddl": {
      "command": "npx",
      "args": ["-y", "@ossuminc/riddl-mcp-server"]
    }
  }
}
3

Restart Claude and start asking about your domain model

Using a different AI client? See the setup guide for Cursor, Windsurf, and other MCP-compatible tools.

Want It All in One Package?

Synapify bundles the MCP server with Claude Opus, a visual editor, and simulation tools at the same cost. No setup, no configuration files, just install and start modeling.

Or subscribe to the standalone MCP server if you prefer your own AI client and workflow.

Download Synapify View Pricing