# Gateway Architect

> Gateway Architect is an MCP server for developer tools. Give coding agents your team's architectural decisions and what happened when they shipped. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API
- **Website:** https://www.gatewayarchitect.com/mcp
- **MCP Registry name:** ai.gatewayarchitect/decisions
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-16

## About

Coding agents can read your code but not the reasoning behind it, so they tend to re-argue choices a team settled a year ago. Gateway Architect keeps a corpus of an organization's decisions and returns the relevant ones while the agent works. It is a hosted endpoint with nothing to install; the docs warn to use the www host exactly, because the bare domain redirects and clients drop the Authorization header.

Two ways to connect decide what an agent may do. A token minted by an admin gets 11 read and record tools and suits pipelines and scheduled jobs. Signing in through a browser, with an authenticator code and a choice of organization, adds 5 tools that create or revise decisions, each carrying the signer's name. Reads are scoped to what the issuing person can already see, and no tool can cross organizations.

The server deliberately cannot approve or reject. capture_decision only creates decisions awaiting review, update_decision cannot change status, and approval columns are writable only by the server after a permission check. Rate limit is 60 requests a minute per token. Plans run from an individual tier with a 14-day trial up to enterprise.

## Features

- **Semantic search:** Find decisions by meaning even when titles share none of your words.
- **Scoped constraints:** Fetch the rules a change inside a project or module must respect.
- **Outcome recording:** Write back what happened when a decision was applied.
- **Contradiction ledger:** Show active supersession chains and unresolved contradictions.
- **Propose, never approve:** Agents can capture decisions for review but cannot ratify them.
- **Token or sign-in:** Tokens give 11 tools; browser sign-in unlocks all 16.

## Good for

- Let an agent check prior decisions before changing a service
- Record a measured constraint found during a build
- Find which decisions conflict or were superseded
- Write back the outcome of an architectural choice

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http decisions https://www.gatewayarchitect.ai/api/mcp
```

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

```sh
https://www.gatewayarchitect.ai/api/mcp
```

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

```json
{
  "mcpServers": {
    "decisions": {
      "url": "https://www.gatewayarchitect.ai/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "decisions": {
      "type": "http",
      "url": "https://www.gatewayarchitect.ai/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "decisions": {
      "serverUrl": "https://www.gatewayarchitect.ai/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "decisions": {
      "type": "http",
      "url": "https://www.gatewayarchitect.ai/api/mcp"
    }
  }
}
```

## Tools

- `search_decisions`: Substring search over decision titles.
- `search_semantic`: Rank decisions by meaning.
- `list_projects`: List visible projects.
- `list_modules`: List a project's modules.
- `record_observation`: Record a measured fact or constraint.
- `get_decision_with_relationships`: Read one decision with related decisions.
- `get_constraints_for_scope`: Get constraints for a project or module.
- `relevant_context`: Return decisions that bear on a given one.
- `record_outcome`: Record what happened when a decision was applied.
- `get_corpus_ledger`: Show supersession chains and contradictions.
- `capture_decision`: Create a decision awaiting review.
- `update_decision`: Revise a decision without changing status.
- `relate_decisions`: Link two decisions.
- `move_decision`: Move a decision to another module.
- `copy_decision`: Copy a decision into another project.
- `get_server_info`: Show server version and tool list revision.

## FAQ

### Which tools does a token get?

11 read and record tools. The 5 that create or revise decisions need a browser sign-in.

### Can an agent approve a decision?

No. Agents can propose decisions awaiting review but cannot approve or reject them.

### What is the rate limit?

60 requests per minute per token, adjustable per token.

### Is there a trial?

Self-serve plans start with a 14-day trial; a card is taken but not charged until it ends.

### Is Gateway Architect free?

Gateway Architect is a paid product with a free trial.

### How do I add Gateway Architect to Claude Code?

Run this command in your terminal: claude mcp add --transport http decisions https://www.gatewayarchitect.ai/api/mcp

### What are the best alternatives to Gateway Architect?

The closest alternatives to Gateway Architect 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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/gateway-architect
