# Keystone

> Keystone is a freemium MCP server for developer tools. Keep a C4 architecture model of your codebase and hand your AI the slice it needs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://keystone-core.pro
- **Repository:** https://github.com/runafterasun/keystone-core
- **MCP Registry name:** pro.keystone-core/keystone
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Keystone keeps a model of your software as systems, services, components with public APIs, and databases down to tables and columns. Your AI coding assistant builds it by reading the repository in your own environment, so no source is uploaded; it sends Keystone elements, relationships, descriptions and evidence, which may contain code fragments.

Proposals arrive as a branch your team reviews, with field-by-field three-way merges. After code changes the AI can check the diagram for drift, by hand or from a CI job it generates for GitHub Actions or GitLab CI. The agent can request one module, what depends on an element, a path between two elements, or only what changed since last time.

The maker reports 68 to 77 percent fewer input tokens for a single-module question than sending the whole model, measured on one anonymized project. Scenarios, ADRs, antipattern review, live co-editing and exports to PNG, SVG, Mermaid, Structurizr DSL and Obsidian are included.

## Features

- **Model built from code:** Your AI proposes elements from code, config and migrations.
- **Focused context:** Returns a module, its API or a database instead of the whole graph.
- **Drift checks:** Compare the diagram with code, manually or from CI.
- **Review by branch:** Every AI proposal arrives as a branch you correct, merge or reject.
- **Decisions and scenarios:** Attach ADRs to elements and play scenarios as sequence diagrams.
- **Open exports:** PNG, SVG, Mermaid, Structurizr DSL and Obsidian notes.

## Good for

- Give an AI assistant architecture context for a task
- Detect drift between diagrams and code
- Document services and database tables from migrations
- Review antipatterns with remediation plans
- Share architecture decisions with a team

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http keystone https://keystone-core.pro/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://keystone-core.pro/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "keystone": {
      "type": "http",
      "url": "https://keystone-core.pro/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "keystone": {
      "serverUrl": "https://keystone-core.pro/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "keystone": {
      "type": "http",
      "url": "https://keystone-core.pro/mcp"
    }
  }
}
```

## FAQ

### Does Keystone get my source code?

You do not upload the repository; your AI reads it locally and sends architecture details, which can include code snippets.

### Which tools work with it?

MCP clients including Claude Code, Cursor, VS Code with Copilot, Gemini CLI and Windsurf.

### Is there a free plan?

The site says a free plan is available.

### Can it run in my network?

The site says companies can also run Keystone inside their own network.

### Is Keystone free?

Keystone has a free plan, with paid plans for more usage or features.

### How do I add Keystone to Claude Code?

Run this command in your terminal: claude mcp add --transport http keystone https://keystone-core.pro/mcp

### What are the best alternatives to Keystone?

The closest alternatives to Keystone are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/keystone
