tentra
Supports Docker Compose export format for architecture designs, enabling containerized deployment of generated system architectures.
Supports Elixir Phoenix framework export format for architecture designs, generating project scaffolds in Elixir.
Supports Python FastAPI framework export format for architecture designs, generating project scaffolds in Python.
Supports Node.js Fastify framework export format for architecture designs, generating project scaffolds in Node.js.
Provides one-click GitHub sign-in authentication for accessing the Tentra service without API keys.
Supports parsing and storing GraphQL API contracts through the record_contract tool, enabling contract management and binding to implementation symbols.
Supports Kotlin Ktor framework export format for architecture designs, generating project scaffolds in Kotlin.
Supports Kotlin Ktor framework export format for architecture designs, generating project scaffolds in Kotlin.
Supports PHP Laravel framework export format for architecture designs, generating project scaffolds in PHP.
Supports Mermaid diagram export format for architecture designs, enabling visualization of system architectures.
Supports .NET ASP.NET framework export format for architecture designs, generating project scaffolds in .NET.
Supports Node.js Fastify framework export format for architecture designs, generating project scaffolds in Node.js.
Supports PHP Laravel framework export format for architecture designs, generating project scaffolds in PHP.
Can be included in architecture designs (e.g., payment systems with PostgreSQL) and supports database component modeling in generated architectures.
Supports Python FastAPI framework export format for architecture designs, generating project scaffolds in Python.
Supports Ruby on Rails framework export format for architecture designs, generating project scaffolds in Ruby.
Supports Rust Axum framework export format for architecture designs, generating project scaffolds in Rust.
Supports Java Spring Boot framework export format for architecture designs, generating project scaffolds in Java.
Supports Java Spring Boot framework export format for architecture designs, generating project scaffolds in Java.
Can be included in architecture designs (e.g., payment systems with Stripe) and supports payment service modeling in generated architectures.
Supports Terraform export format for architecture designs, enabling infrastructure-as-code provisioning of generated system architectures.
tentra-mcp
Memory for AI coding agents. Persistent code graph + AI-generated architecture diagrams — MCP-native. Works in Cursor, Claude Code, Codex, and Windsurf.
Dogfood benchmark on our own monorepo: 99.4% token reduction (156.8× ratio) across 8 "where is X implemented?" queries — 114,644 tokens via file re-read vs 731 tokens via query_symbols. Full write-up →
Quick Start
npx tentra-mcpOn first use, your browser opens for one-click GitHub sign-in. That's it — no API key needed.
Advanced: If you prefer to use an API key directly, run
npx tentra-mcp --key YOUR_API_KEY. Get your key at trytentra.com/settings.
What is Tentra?
Tentra is the persistent memory layer for AI coding agents. Describe a system — get a diagram and 14-framework code exports. Index your repo — agents query a structured graph of files, symbols, imports, and call edges instead of re-grepping source every session.
This MCP server gives your AI assistant 32 tools:
Architecture (9 tools)
Tool | Description |
| Design a new system from a description |
| Modify an existing architecture |
| Read architecture details |
| Browse all saved designs |
| Scan local code and generate diagram |
| Quality checks (9 rules: orphans, SPOFs, god services) |
| Detect drift between diagram and code |
| Export to 14 frameworks (Java, Python, Go, Rust, etc.) |
| Create step-by-step flow visualization |
Code Graph — Write (4 tools)
Tool | Description |
| Walk a repo, Tree-sitter locally, start a semantic indexing job |
| Resume an in-progress indexing job |
| Persist an agent-extracted semantic annotation |
| Check status of an indexing job |
Code Graph — Read (10 tools)
Tool | Description |
| Fuzzy trigram search across indexed symbols |
| BFS traversal in the call/import graph |
| Subgraph for a canvas service |
| Shortest path between two symbols with semantic context |
| pgvector cosine ANN over agent-generated embeddings |
| Persist an agent-generated embedding vector |
| Highest fan-in/out symbols (architectural smells) |
| Churn × complexity ranking |
| Time-travel listing of indexed snapshots |
| Files / symbols / god-nodes added/removed between snapshots |
Enrichment — Contracts, Decisions, Ownership, Domains (9 tools)
Tool | Description |
| Link an indexed file or symbol to a canvas service |
| Assign a service or file to a domain (bounded context) |
| Store a parsed API contract payload (OpenAPI, GraphQL, Protobuf) |
| Link a contract to the symbol that implements it |
| Create an Architecture Decision Record, optionally linking code |
| Append a link from an ADR to another symbol, file, or service |
| Resolve the owner (team or person) for a file or service |
| List ADRs linked to a given entity |
| List contracts, optionally filtered by kind or service |
Setup
Option 1: SSE (zero install)
Add to your IDE's MCP config — no local install needed:
Cursor (Settings > Features > MCP > Add Server):
{
"tentra": {
"type": "sse",
"url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
}
}Claude Code (.mcp.json in project root):
{
"mcpServers": {
"tentra": {
"type": "sse",
"url": "https://trytentra.com/api/mcp?key=YOUR_API_KEY"
}
}
}Option 2: Local install (needed for codebase scanning)
npx tentra-mcpAuthenticates automatically via GitHub on first use. Credentials are saved to ~/.tentra/credentials.
Cursor config for local server:
{
"tentra": {
"command": "npx",
"args": ["tentra-mcp"]
}
}Claude Code (.mcp.json):
{
"mcpServers": {
"tentra": {
"command": "npx",
"args": ["tentra-mcp"]
}
}
}Usage Examples
Once connected, just talk to your AI:
"Design a payment system with Stripe, Kafka, and PostgreSQL"
→ AI calls create_architecture → diagram at trytentra.com/arch/xxx
"Scan this codebase and generate the architecture"
→ AI calls analyze_codebase → detects services, DBs, queues
"Export this architecture to Java Spring Boot"
→ AI calls export_architecture → downloads zip with project scaffold
"What changed since last time? Is my diagram outdated?"
→ AI calls sync_architecture → drift report with accuracy scoreExport Formats
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, Terraform
Links
Website: trytentra.com
Documentation: trytentra.com/docs
Setup Guide: trytentra.com/docs/setup
Gallery: trytentra.com/gallery
Development
This repo contains the open-source MCP server. The Tentra API and web app are a separate hosted service at trytentra.com.
npm install --legacy-peer-deps
npm run build # tsc --noEmit + esbuild bundle → dist/index.js
npm start # run the bundled server
npm test # vitestThe published npm package (tentra-mcp) ships only the bundled dist/ — source is here for auditability and community contributions.
License
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rdanieli/tentra-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server