# Archstone

> Archstone is an open-source MCP server for developer tools. Compile business capabilities written in YAML into MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://archstone.dev
- **Repository:** https://github.com/archstone-romania/archstone
- **MCP Registry name:** io.github.Archstone-Romania/archstone
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Archstone is a compiler. You describe what your business can do in a declarative format, and it generates tools an AI agent can discover and call, with MCP as the first target and other protocols to follow. The README shows a tourism search integration that comes to 12 lines of business YAML, with no HTTP, JSON Schema or MCP SDK code by hand.

The CLI has commands to draft a manifest from an OpenAPI document or a Postgres catalogue (init), validate and compile (apply), serve over stdio or HTTP (serve), replay recorded fixtures to detect drift against the live backend (verify) and run a pre-production checklist (doctor). A live demo runs at demo.archstone.dev/mcp, and its read-only tools need no key.

The code is Apache-2.0 licensed. A hosted console is also offered for small businesses that want customers to add their prices to an AI assistant, free on every plan until 1 December.

## Features

- **Declarative manifests:** Business capabilities are written once in YAML.
- **OpenAPI starting point:** archstone init drafts a manifest from an OpenAPI spec.
- **Drift checks:** verify replays fixtures against the live backend.
- **Exposure review:** apply --exposure shows what a model can and cannot see.
- **Stdio or HTTP:** serve runs over stdio, or HTTP with a token.
- **Embeddable:** Compiled output can be called from your own agent loop.

## Good for

- Expose a shop's live prices and stock to customers' AI assistants
- Turn an existing OpenAPI spec into an agent-ready tool set
- Detect when a backend drifts from its recorded behaviour
- Prototype a business connector without writing MCP code

## Install

### Claude Code (Terminal)

```sh
claude mcp add archstone -- npx -y @archstone/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "archstone": {
      "command": "npx",
      "args": [
        "-y",
        "@archstone/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "archstone": {
      "command": "npx",
      "args": [
        "-y",
        "@archstone/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "archstone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@archstone/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "archstone": {
      "command": "npx",
      "args": [
        "-y",
        "@archstone/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "archstone": {
      "command": "npx",
      "args": [
        "-y",
        "@archstone/cli"
      ]
    }
  }
}
```

## FAQ

### What licence is it under?

The README says Apache-2.0.

### What do I need to install it?

Node 22 or later and the @archstone/cli npm package.

### Can I try it first?

Yes. A live demo endpoint is available, and its read-only tools need no key.

### Is there a hosted option?

The site describes a console for businesses, free on every plan until 1 December.

### Is Archstone free?

Yes. Archstone is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add archstone -- npx -y @archstone/cli

### What are the best alternatives to Archstone?

The closest alternatives to Archstone 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/archstone
