# mcp

A local MCP server named sapiom-dev that lets a coding agent scaffold, validate and run Sapiom agents on your machine, then deploy and inspect them in the cloud.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Author: sapiom
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sapiom/sapiom-js/tree/HEAD/packages/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/sapiom-mcp

## What it does

The server runs over stdio on your own machine under the name `sapiom-dev`. `sapiom_dev_agents_scaffold` sets up a fresh agent project, `sapiom_dev_agents_check` validates types, imports, the bundle and the step graph, and `sapiom_dev_agents_run_local` executes the code locally. During a local run only `ctx.sapiom.*` calls get replaced with stubs; network access, filesystem writes and process calls in author code still happen for real.

Networked tools — `link`, `deploy`, `run`, `inspect`, `signal` — need a Sapiom API key. Trigger `sapiom_authenticate` once and a browser login opens; the key is then cached per environment in `~/.sapiom/credentials.json`. Keys are sent over `https://` or over plain `http://` to a loopback host only, and a request to any other `http://` target is refused before it leaves. Trusted private networks can opt out with `SAPIOM_ALLOW_INSECURE_HTTP=1` in the server `env`.

This is not the hosted Sapiom MCP with capability tools. No capability tool lives here. Deploys, cloud builds, production runs, signals and schedules touch Sapiom cloud state and may be metered. The local tools `scaffold`, `check` and `run_local` need no authentication, though `scaffold` may query npm for current dependency versions.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @sapiom/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @sapiom/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@sapiom/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@sapiom/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @sapiom/mcp
```

## When to use it
- start a new Sapiom agent project from the agent
- catch type and step-graph errors before deploying
- run an agent locally without Sapiom capability spend
- publish an app to a live sandbox URL that expires with its `ttl`
- wait on a cloud execution or build and read the result

## Example prompts
- Scaffold a new Sapiom agent project and list the generated files
- Check the project before deploy: types, bundle and step graph
- Run the agent locally and show what each step returned

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md