# OuterSpace Apizr

> OuterSpace Apizr is an open-source MCP server for developer tools. Read-only analysis of Python projects and experiment history for MCP clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://apizr.outerspace.sh/reference/apizr-mcp-server/
- **Repository:** https://github.com/alien6-studio/outerspace-apizr/tree/HEAD/plugins/mcp
- **MCP Registry name:** io.github.Alien6-Studio/outerspace-apizr
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Apizr's plugin lets an assistant look at a Python project without running any of its functions. You pick one project through an `apizr.toml` file, a readiness policy and an exposure policy, and the server freezes those values at startup; edits only apply after a restart.

Access is granted explicitly. An operator policy file lists grants such as `source.analyze`, and reading recorded experiments needs a separate `history.read` grant with `experiments.read`. Tool arguments cannot point at another root, store or authority, and the project root is anchored by filesystem identity so symlinks cannot redirect a calculation.

Version 0.4.6 adds three experiment tools that read the project's `.apizr/experiments/v1` store and compare runs without inferring causality. It needs matching Apizr core and plugin versions, and is released under GPL-3.0-or-later for Python 3.11 to 3.15.

## Features

- **Read-only source analysis:** Inspects a Python project and reports which functions are ready to expose, without executing them.
- **Exposure planning:** Prepares a plan for the functions you select in the exposure policy, for REST and MCP interfaces.
- **Experiment history:** Lists, shows and diffs recorded experiments from the project's local store.
- **Explicit permission grants:** Analysis and history reads each need their own grant in the operator policy.
- **Frozen configuration:** Project config and policies are fixed at startup and change only on restart.
- **Bounded history validation:** Every history read validates the whole bounded store, so filters never hide corruption.

## Good for

- Let an assistant review which Python functions are safe to expose as an API
- Compare recorded experiment runs from inside an MCP client
- Plan which functions to publish before generating REST or MCP interfaces
- Audit a codebase with an assistant that cannot execute project code

## Install

### Claude Code (Terminal)

```sh
claude mcp add outerspace-apizr -- uvx outerspace-apizr-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "outerspace-apizr": {
      "command": "uvx",
      "args": [
        "outerspace-apizr-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "outerspace-apizr": {
      "command": "uvx",
      "args": [
        "outerspace-apizr-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "outerspace-apizr": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "outerspace-apizr-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "outerspace-apizr": {
      "command": "uvx",
      "args": [
        "outerspace-apizr-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "outerspace-apizr": {
      "command": "uvx",
      "args": [
        "outerspace-apizr-mcp"
      ]
    }
  }
}
```

## Tools

- `apizr_experiment_list`: Lists recorded experiments from the project's .apizr/experiments/v1 store.
- `apizr_experiment_show`: Shows one recorded experiment from the history store.
- `apizr_experiment_diff`: Compares recorded experiments without inferring causality.

## FAQ

### Does it run my project's functions?

No. By default it is read-only and analyses source without executing functions.

### How is experiment history access controlled?

It needs an exact history.read grant with experiments.read, in addition to source.analyze. Installing the plugin or granting analysis alone gives no history access.

### Which Python versions are supported?

The README lists Python 3.11 to 3.15, with Apizr 0.4.6 and the matching plugin version.

### What licence is it under?

GPL-3.0-or-later, according to the README.

### Is OuterSpace Apizr free?

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

### How do I add OuterSpace Apizr to Claude Code?

Run this command in your terminal: claude mcp add outerspace-apizr -- uvx outerspace-apizr-mcp

### What are the best alternatives to OuterSpace Apizr?

The closest alternatives to OuterSpace Apizr 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/outerspace-apizr
