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.

View on GitHub Documentation

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
  • explain-error

Guidance

  • suggest-next
  • map-domain-to-riddl

Templates

  • expand-pattern
  • list-patterns
  • list-templates
  • get-template

Testing

  • 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.

Available Resources

  • EBNF Grammar
  • Language Guide
  • 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.

🧩

Pattern Application

Apply proven DDD patterns to your domain with AI guidance.

Quick Setup

Add the RIDDL MCP Server to your Claude Desktop configuration: 

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

See the full setup guide for detailed instructions and configuration options.

Start Using AI-Assisted Domain Modeling

The RIDDL MCP Server is open source. Try it today with Claude Desktop or integrate it into your own AI workflows.

Get Started Get Help