Back to Browse

Keystone Core MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

C4 architecture model of your system, built from code by your AI and read back as focused context.

About

C4 architecture model of your system, built from code by your AI and read back as focused context.

Remote endpoints: streamable-http: https://keystone-core.pro/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "pro-keystone-core-keystone": {
      "url": "https://keystone-core.pro/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Keystone

Understand your system before you change it.

Keystone keeps a C4 model of your software: systems, services, components with their public API, databases down to tables and columns, scenarios and architecture decisions. Your AI coding assistant builds the model from the code in your environment, keeps it in step with the code and reads it back over MCP as context for its next task. Every change arrives as a branch that your team reviews.

This repository holds no source code: it is the public home of Keystone for its MCP server, docs links and feedback.

What it does

  • Builds the architecture from code. Your AI reads the repository where it already works and proposes the model: context, containers, components, ER diagrams from migrations. Keystone never receives your source code.
  • Gives the agent the part it needs. The agent asks for one module, what depends on an element, the path between two elements or only what changed since last time, instead of the whole model.
  • Keeps the model current. After code changes the AI checks the diagram against the code and sends a proposal, by hand or from CI: the AI assistant generates the job for GitHub Actions or GitLab CI.
  • You stay the reviewer. Every AI proposal arrives as a branch: open it, correct it, merge it or reject it. Merges are three-way, field by field.
  • More than boxes. Scenarios, architecture decisions (ADR) bound to elements, impact analysis, antipattern review with remediation plans, comments, live co-editing, roles and access, system design interview practice.
  • No lock-in. Export to PNG, SVG, Markdown with Mermaid, Structurizr DSL and Obsidian notes; import a Structurizr workspace (JSON or DSL).

On a question about one module, the module slice took 68–77% fewer input tokens than sending the whole model, with the same facts in the answer. This compares a slice with the whole model, not a whole coding task (method and limits).

Claude Code plugin

Install Keystone as a plugin; Claude Code asks for your token once and keeps it in secure storage:

/plugin install keystone-architecture --marketplace runafterasun/keystone-core

Connect your AI

  1. Sign in at https://keystone-core.pro and open a project → AI assistant → Connection → Create token.
  2. Add the MCP server in the folder with the code of that project, or install the plugin above.

Claude Code

claude mcp add --scope local --transport http keystone https://keystone-core.pro/mcp --header "Authorization: Bearer ks_…"

Cursor (.cursor/mcp.json)

{ "mcpServers": { "keystone": { "url": "https://keystone-core.pro/mcp", "headers": { "Authorization": "Bearer ks_…" } } } }

VS Code with GitHub Copilot (.vscode/mcp.json)

{ "servers": { "keystone": { "type": "http", "url": "https://keystone-core.pro/mcp", "headers": { "Authorization": "Bearer ks_…" } } } }

Gemini CLI (.gemini/settings.json)

{ "mcpServers": { "keystone": { "httpUrl": "https://keystone-core.pro/mcp", "headers": { "Authorization": "Bearer ks_…" } } } }

Windsurf (~/.codeium/windsurf/mcp_config.json)

{ "mcpServers": { "keystone": { "serverUrl": "https://keystone-core.pro/mcp", "headers": { "Authorization": "Bearer ks_…" } } } }

Clients with local (stdio) servers only, through the mcp-remote bridge (needs Node.js):

{ "mcpServers": { "keystone": { "command": "npx", "args": ["-y", "mcp-remote", "https://keystone-core.pro/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer ks_…" } } } }

A token follows the current role of its owner in the project: a viewer's token only reads. More in the guide.

Prompts

Ready commands the server offers to your client, for example in Claude Code /mcp__keystone__build_architecture <project link>:

PromptWhat it does
build_architectureContext and containers from the code
build_architecture__fullThe whole architecture: also components and tables
describe_containerBreak a container into components with their public API
describe_databaseDraw the ER diagram of a database from its migrations
describe_scenarioTrace a scenario through the architecture
record_decision, import_decisionsRecord an architecture decision, import existing ADRs
validate_architectureCheck the diagram against the code
syncBring the diagram up to date with the commits since the last sync
analyze_impactWhat a change of an element affects, with paths and reasons
review_antipatterns, plan_remediationFind architecture antipatterns, plan their fixes in stages
system_design_interviewPractise a system design interview on a real diagram

Tools

Reading tools return the part of the model a task needs:

ToolWhat it returns
search_architectureElements and tables by name, role or module, with IDs and ready reads for the hits
get_architectureThe whole model as a short map, one module or chosen elements in full
traverse_architectureWhat depends on an element and what it depends on, to a chosen depth
analyze_impactWhat a change of an element or table affects, with reasons and paths
find_architecture_pathThe chain of calls and data access between two elements
get_architecture_deltaOnly what changed since a version of the model
find_antipattern_candidatesShared databases, cycles of synchronous calls, overloaded services

Changes go through propose_changes only: a proposal becomes a branch that a person reviews and merges. Checks against the code and antipattern findings are reported with report_validation and report_antipatterns.

Plans and hosting

  • keystone-core.pro has a free plan with limits.
  • Self-hosted inside your own network for companies: contact us.

Feedback

Questions, ideas and bug reports are welcome as issues.

Reviews

No reviews yet

Be the first to review this server!