{"report":{"v":1,"package":"@contentrain/mcp","version":"3.12.3","ranAt":"2026-11-16T11:33:22.998Z","install":{"ok":true,"integrity":"sha512-Uy9BeSyhLh2Hum7GeN2lBnlolQBE2pFm8rgVioOQiy3ozTyBMFklMNvmcZYpQPW0hSnZOs5mBysijmcW6y7EkA==","deps":138,"scripts":[],"bins":["contentrain-mcp"],"license":"MIT","repository":"git+https://github.com/Contentrain/ai.git","bin":"contentrain-mcp"},"start":{"ok":true,"ms":358,"serverName":"contentrain-mcp","serverVersion":"3.12.3","protocol":"2025-06-18"},"tools":[{"name":"contentrain_status","description":"Get full project status (read-only). Returns config, models, context. Do NOT manually edit .contentrain/ based on this output.","params":[]},{"name":"contentrain_describe","description":"Get full schema of a single model (read-only). Do NOT manually create content files — use contentrain_content_save instead.","params":["model","include_sample","locale"]},{"name":"contentrain_describe_format","description":"Describes the Contentrain content file format for any language/platform. Returns a comprehensive specification of the file structure, JSON formats, markdown conventions, meta files, and locale strategies.","params":[]},{"name":"contentrain_init","description":"Initialize .contentrain/ structure. Changes are auto-committed to git — do NOT manually create .contentrain/ files.","params":["stack","locales","domains"]},{"name":"contentrain_scaffold","description":"Template-based project setup. Available templates: blog, landing, docs, ecommerce, saas, i18n, mobile. Changes are auto-committed to git.","params":["template","locales","with_sample_content"]},{"name":"contentrain_model_save","description":"Create or update a model definition. Changes are auto-committed to git — do NOT manually edit .contentrain/ files after calling this tool.","params":["id","name","kind","domain","i18n","locales","title_field","description","fields","content_path","locale_strategy"]},{"name":"contentrain_model_delete","description":"Delete a model and its content/meta. Changes are auto-committed to git — do NOT manually edit .contentrain/ files.","params":["model","confirm"]},{"name":"contentrain_content_save","description":"Save content entries. Entry format varies by model kind: DICTIONARY — provide \"locale\" and \"data\" (flat key-value, all string values); \"id\" and \"slug\" are ignored; data keys are the identities. COLLECTION — provide \"locale\" and \"data\"; \"id\" is optional (auto-generated if omitted); \"slug\" is ignored. DOCUMENT — provide \"slug\" (required), \"locale\", and \"data\"; use the \"body\" key inside data for markdown content. SINGLETON — provide only \"locale\" and \"data\". MEDIA FIELDS (image/video/file): for a media-library asset, pass its storage path (\"media/...\") or URL; in cloud mode these are automatically normalized to absolute public delivery URLs on save (in markdown bodies too), so saved content renders in a browser anywhere with no SDK — in local mode the relative path is kept as-is. For external images (e.g. a CDN or Unsplash URL), pass the URL directly; it is saved untouched. Changes are auto-committed to git — do NOT manually edit .contentrain/ files after calling this tool.","params":["model","entries"]},{"name":"contentrain_content_delete","description":"Delete content entries. For dictionaries, use \"keys\" to remove specific keys (omit to delete entire locale file). Changes are auto-committed to git — do NOT manually edit .contentrain/ files after calling this tool.","params":["model","id","slug","locale","keys","confirm"]},{"name":"contentrain_content_list","description":"List content entries (read-only). Each entry carries its publish state under \"meta\" — status, plus publish_at/expire_at when set — read from the listed locale's meta; singletons and dictionaries carry it at the top level. Local and remote sessions return the same shape. Change status with contentrain_content_status. Returns data from .contentrain/ — do NOT manually create or modify content files.","params":["model","locale","filter","resolve","limit","offset"]},{"name":"contentrain_content_status","description":"Change the status of content entries — this is how an entry is published, unpublished or archived. Address records the way their meta is laid out: COLLECTION — \"entry_ids\"; DOCUMENT — \"slugs\"; SINGLETON and DICTIONARY — neither (one record per locale). i18n models change every supported locale unless \"locale\" is given. Setting status \"published\" validates the targeted entries first; if they have errors, nothing is committed. Records already at the requested status are reported as unchanged and not rewritten. contentrain_content_list shows each entry's current status under \"meta\". Changes are committed to git and follow the project's review or auto-merge workflow — do NOT manually edit .contentrain/meta files.","params":["model","status","entry_ids","slugs","locale"]},{"name":"contentrain_vocabulary_save","description":"Add or update canonical vocabulary terms. Terms nest as { \"term-slug\": { \"en\": \"…\", \"tr\": \"…\" } } — the OUTER key is the term, the INNER key is a locale. Merges with the existing vocabulary: a term you omit is untouched. Changes are auto-committed to git — do NOT manually edit .contentrain/vocabulary.json.","params":["terms"]},{"name":"contentrain_vocabulary_delete","description":"Remove canonical vocabulary terms by slug. Content already using a term is not touched — the vocabulary only advises. Changes are auto-committed to git.","params":["terms","confirm"]},{"name":"contentrain_validate","description":"Validate project content against model schemas. Detects required field violations, type mismatches, broken relations, secret leaks, i18n parity issues, and more. If fix:true, auto-fixes structural issues (canonical sort, orphan meta, missing locale files, stray non-i18n meta layout, scheduling keys an older content_save leaked into document frontmatter) and backfills a missing model title_field — do NOT manually edit .contentrain/ files. Content without meta gets meta with status published, matching what delivery already serves. A fix that would change whether an entry is delivered is listed in visibility_changes and left on its branch for review instead of auto-merged.","params":["model","fix"]},{"name":"contentrain_submit","description":"Push cr/* branches to remote. MCP is push-only — PR creation is handled by the platform. Do NOT manually push or create PRs.","params":["branches","message"]},{"name":"contentrain_merge","description":"Merge a review-mode branch into contentrain. Local git operation — no external platform needed. Merges the feature branch into the contentrain branch, advances the base branch via update-ref, selectively syncs .contentrain/ files to the working tree, and prunes the merged branch. Target by exact \"branch\" name, or resolve by \"model\" (+ optional \"locale\"/\"latest\").","params":["branch","model","locale","latest","confirm"]},{"name":"contentrain_branch_list","description":"List pending contentrain (cr/*) branches with their merge status against the contentrain branch. Use this to discover branch names for contentrain_merge / contentrain_branch_delete, and to monitor branch-health limits (warning at 50, blocked at 80 unmerged).","params":["unmerged_only","remote"]},{"name":"contentrain_branch_delete","description":"Delete a pending contentrain (cr/*) branch that will not be merged — e.g. a branch left behind by a failed operation, or a superseded draft. Only cr/* branches can be deleted; the contentrain branch is protected. This is destructive: the branch and its unmerged commits are removed.","params":["branch","confirm"]},{"name":"contentrain_reconcile","description":"Reconcile a diverged contentrain ↔ base-branch pair with a content-aware three-way merge. DRY RUN (default, dry_run:true): reports what would merge and which conflicts need a decision — touches nothing. EXECUTE (dry_run:false): performs the merge as a two-parent commit on contentrain and fast-forwards the base branch. Everything one side changed merges mechanically (entry-, key-, term+locale-level); only the same item changed differently on both sides becomes a conflict. Answer conflicts by passing resolutions (from the dry-run ids) and running again — a resolution whose values changed since the dry-run is dropped and the conflict re-reported. Recommended workflow: always run dry_run first, review the summary and conflicts, then execute.","params":["dry_run","resolutions"]},{"name":"contentrain_scan","description":"Scan project source code for content strings. Three modes: \"graph\" builds import/component graph for project intelligence, \"candidates\" extracts string literals with pre-filtering and pagination, \"summary\" provides quick overview stats. Read-only — no changes to disk or git. MCP finds strings deterministically; the agent decides what is content. Recommended workflow: start with \"summary\" or \"graph\" for orientation, then paginate through \"candidates\" to evaluate strings.","params":["mode","paths","include","exclude","limit","offset","min_length","max_length"]},{"name":"contentrain_apply","description":"Apply normalize operations. Two modes: \"extract\" writes agent-approved strings to Contentrain content files (source untouched), \"reuse\" patches source files with agent-provided replacement expressions. DRY RUN (default, dry_run:true): validates inputs, resolves conflicts, and returns a full preview — NO changes to disk or git. EXECUTE (dry_run:false): writes files to disk, commits to a branch, and requires branch health check to pass. Recommended workflow: always run dry_run first, review the preview, then call again with dry_run:false to execute. Normalize operations always use review workflow (never auto-merge).","params":["mode","dry_run","extractions","scope","patches"]},{"name":"contentrain_bulk","description":"Batch operations on content entries: copy a locale, or delete many collection entries. All operations are auto-committed to git. To publish or change status, use contentrain_content_status. DRY RUN (dry_run:true): runs the whole operation in a throwaway worktree and reports exactly what would change — nothing is committed and no branch survives. Recommended workflow: preview with dry_run:true, review the counts, then call again to execute.","params":["operation","model","source_locale","target_locale","entry_ids","confirm","dry_run"]},{"name":"contentrain_doctor","description":"Project health report (read-only). Returns structured checks: git, node, .contentrain/ structure, model parse, orphan content, branch pressure, SDK freshness. Pass `usage: true` for a deeper analysis of content-key references in source files (unused keys, duplicate dictionary values, locale coverage). Local-filesystem only — unavailable over remote providers.","params":["usage"]}],"toolsHash":"f94f18175e5c1e3bf548a16b38d2844cd01d48c2e97f7cca67fe97ccab8be8a7","wrote":[],"callsAt":"2026-11-16T11:33:30.892Z","calls":[{"tool":"contentrain_status","ok":true,"ms":14,"bytes":179},{"tool":"contentrain_describe_format","ok":true,"ms":2,"bytes":9144},{"tool":"contentrain_branch_list","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: {\n  \"error\": \"Error: spawn git ENOENT\\n    at ChildProcess._handle.onexit (node:internal/child_process:316:19)\\n    at onErrorNT (node:internal/child_process:554:16)\\n    at process.processTicksAndRej"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":23,"wrote":0,"callsTried":3,"callsAnswered":2,"callContacts":[]},"history":[{"package":"@contentrain/mcp","version":"3.12.3","ranAt":"2026-11-16T11:33:22.998Z","outcome":"started","tools":23,"contacts":0,"flags":0,"serious":0,"toolsHash":"f94f18175e5c1e3bf548a16b38d2844cd01d48c2e97f7cca67fe97ccab8be8a7"}],"page":"https://bragproof.smaverk.com/r/%40contentrain/mcp"}