About Rosentic
Rosentic is an MCP server for AI coding agents that checks whether active Git branches have structural contract conflicts before merging. It uses local tree-sitter AST analysis across 15+ languages rather than AI code review.
Key features
- 01Cross-branch contract checks
- 02Function signature mismatch detection
- 03HTTP route conflict detection
- 04Schema mismatch detection
- 05Conflict explanations
- 06Local repository scanning
Use cases
- 01Check branch compatibility before merging
- 02Find callers affected by changed function signatures
- 03Detect API request or route conflicts
- 04Identify schema changes that break dependent branches
MCP support
It provides the `check_conflicts`, `explain_conflict`, and `list_branches` tools to MCP clients. Scans run locally against the Git repository.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| base | string | No | Base branch used for branch diffs. Defaults to main. |
| branch | any | No | Branch to check against other active branches. If omitted, the current checked-out branch is used. |
| format | enum | No | Use summary for concise text. Use json only when the agent needs finding_ids or full structured findings.summary | json |
| branches | any | No | Explicit list of branch names to scan. Bypasses enumeration and age filters. Use this when you know exactly which branches to check. |
| repo_path | string | Yes | Absolute or relative path to the local git repository to scan. |
Details
From the project READMERosentic - Cross-Branch Merge Safety
Rosentic checks whether your active branches are compatible with each other before merge. It detects broken function signatures, HTTP route conflicts, and schema mismatches across 15+ languages using deterministic AST analysis.
This is not AI code review. Rosentic finds structural contract conflicts that would cause runtime failures after merge - the kind of breaks that tests don't catch because they only run on one branch at a time.
Install
pip install rosentic-mcp
Then add to your editor's MCP config:
{
"mcpServers": {
"rosentic": {
"command": "rosentic-mcp",
"args": [],
"env": {}
}
}
}
Works with Cursor, Claude Code, Cline, Windsurf, and any editor that supports MCP.
What it does
Rosentic gives your AI coding agent three MCP tools:
| Tool | Purpose |
|---|---|
check_conflicts | Scan a repo for cross-branch contract conflicts |
explain_conflict | Explain a specific finding and what to do about it |
list_branches | List active branches so the agent can choose what to scan |
Example conflicts Rosentic catches
- Branch A adds a required parameter to
createOrder(). Branch B callscreateOrder()with the old signature. Both pass CI. Merge breaks production. - Branch A changes
POST /api/usersto requireemailin the request body. Branch B's frontend still sends the old payload. - Branch A removes a field from a GraphQL type that Branch B's query depends on.
How it works
Before you push, open a PR, or merge, your agent runs a cross-branch compatibility check. It calls check_conflicts, which scans your repo's branch heads using tree-sitter AST parsing and reports any conflicts.
No code leaves your machine. The scan runs locally against your git repo.
Compared to Semgrep Guardian
Semgrep Guardian checks each file for security vulnerabilities and code issues. Rosentic checks whether your branches are compatible with each other. They solve different problems and work well together:
- Semgrep Guardian: "Is this code safe and correct on its own?"
- Rosentic: "Will this branch break other branches when merged?"
Links
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.