Log inSubmit server
Tentra MCP logo

Tentra MCP

by rdanieli

Designs typed architectures, indexes codebases, detects drift, and exposes code-graph queries through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Tentra MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "rdanieli-tentra-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tentra-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y tentra-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

rdanieli/tentra-mcp MCP server gives AI coding agents architecture design, codebase analysis, and persistent code-graph tools. Agents can describe a system, generate a typed diagram, run quality checks, compare diagrams with code, and export designs to listed frameworks and formats. A local npm process supports repository scanning and indexing, while an SSE endpoint provides hosted access. Reach for it when an agent needs architecture visibility, symbol-level code queries, drift checks, or architecture documentation.

Use cases

  • Design service architectures from natural-language requirements
  • Index repositories for symbol and call-graph queries
  • Detect drift between saved diagrams and implementation code
  • Export architecture designs into infrastructure or application scaffolds
  • Inspect architectural smells such as god nodes and quality hotspots

Key features

  • Typed architecture diagrams from natural-language descriptions
  • Persistent code graph with symbol, import, and call-edge queries
  • Architecture linting and diagram-to-code drift detection
  • Exports to application, infrastructure, diagram, and ADR formats
  • Git post-commit re-indexing for local repositories
  • Contracts, domains, ownership, and architecture decision records

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/9 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · tentra-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads368Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Tentra MCP works

What rdanieli/tentra-mcp MCP server does

rdanieli/tentra-mcp MCP server connects an AI coding agent to two related capabilities: architecture modeling and a persistent code graph. An agent can turn a natural-language system description into a typed architecture diagram, update saved designs, inspect them, create flow visualizations, and apply nine listed quality checks, including orphan, single-point-of-failure, and god-service detection.

The architecture side also supports codebase analysis, diagram-to-code drift detection, and specification alignment checks. Designs can be exported to the formats listed by the project, including Java Spring Boot, Node.js Fastify, Python FastAPI, Go chi, Rust Axum, .NET ASP.NET, Kotlin Ktor, PHP Laravel, Ruby Rails, Elixir Phoenix, Docker Compose, Mermaid, ADR, and Terraform.

The code-graph side indexes files, symbols, imports, and call edges. Agents can search symbols, find references, prepare rename plans, inspect neighboring symbols, explain code paths, identify highly connected nodes, rank quality hotspots, compare snapshots, and retrieve repository-wide explanations. Additional tools store service mappings, domain membership, contracts, architecture decisions, and ownership data.

How it works

The local process runs through the tentra-mcp npm package and communicates with an MCP client over stdio. npx tentra-mcp init --hook can write configuration for supported installed clients, add a Git post-commit hook, and derive a repository identifier from the Git remote. The hook triggers background re-indexing after commits, keeping the graph updated without a separate manual indexing step.

For architecture operations and hosted access, the server uses the Tentra service at trytentra.com. Codebase scanning requires the local installation rather than the hosted SSE configuration. An agent invokes the available MCP tools; the server handles indexing jobs and persistence for the resulting graph data.

Setup and configuration

Install the local server with npx tentra-mcp. For repository-aware setup, run the project’s initialization command from the repository and optionally include --hook. The generated configuration can then be reloaded in the MCP client. The README names Cursor, Claude Code, Codex, and Windsurf as supported configuration targets.

The first local tool call can open GitHub device-flow authentication, with credentials saved under ~/.tentra/credentials. Alternatively, the command accepts an API key using --key. The SSE setup uses an endpoint at https://trytentra.com/api/mcp with the key supplied as a query parameter. The README’s examples use a placeholder key, so that value must be replaced before use.

Tools and capabilities

The listed tool groups cover:

  • Architecture creation, updates, retrieval, listing, codebase analysis, linting, synchronization, alignment checks, exporting, and flow creation.
  • Code-graph indexing, continuation of indexing jobs, semantic annotations, and job-status checks.
  • Symbol search, reference lookup, rename planning, graph traversal, code explanations, similarity search, embeddings, snapshots, god-node detection, and hotspot analysis.
  • Service-to-code mapping, domain assignment, contract recording and lookup, ADR recording and linking, and ownership resolution.

These capabilities let an agent move between a high-level system design and implementation-level evidence rather than relying only on repeated source-file searches.

Limitations and notes

rdanieli/tentra-mcp MCP server is not itself the hosted Tentra web application or API; the repository contains the open-source MCP server, while the API and web app are separate hosted services. The hosted SSE option does not provide the local codebase-scanning path described for the npm process.

Authentication is required for the documented hosted or local service workflows, either through GitHub device flow or an API key. The project is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tentra MCP

Run `npx tentra-mcp` for a manual local stdio setup, or run `npx tentra-mcp init --hook` inside a repository to generate client configuration and optionally install a post-commit hook.

Yes.

The local server can authenticate through a GitHub device flow on first use or accept an API key with `--key`. The hosted SSE configuration passes an API key to the Tentra endpoint.

Yes. The README also names Claude Code and Codex.

Yes. `sync_architecture` compares a saved diagram with code and returns a drift report with an accuracy score; `get_spec_alignment` provides an additional implementation-time drift check.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTentra MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rdanieli-tentra-mcp?style=directory)](https://allmcps.com/mcp/rdanieli-tentra-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/rdanieli-tentra-mcp"><img src="https://allmcps.com/api/badge/rdanieli-tentra-mcp?style=directory" alt="Tentra MCP on AllMCPs" /></a>