# Alloy

Points your agent at the Alloy workspace so it reads team knowledge first, writes artifacts back, and can hand work to cloud agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Alloy-Systems
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Alloy-Systems/work-with-alloy
- Updated: 2026-08-29
- HTML: https://affpapa.org/en/nevibecode/mcp/alloy

## What it does

Alloy is a workspace where people and AI agents share artifacts, knowledge, skills and access to outside systems. This plugin makes Alloy the agent's source of truth. Before answering, the agent pulls company docs, past decisions, knowledge notes and communication history. Afterwards it writes proposals, research, specs, logs and reusable notes that later agents can pick up.

Two skills ship in the repo. `skills/work-with-alloy/` is the core one; `skills/review-alloy-operations/` audits teammates, instruction skills, workflows, MCPs and recent activity. The Codex and Claude manifests are thin wrappers over the same skill content, which keeps the skills host-neutral. Business systems arrive through Alloy-controlled MCP: the agent connects once, and Alloy decides which upstream MCPs, APIs, files and secrets it can reach.

You need an `ALLOY_TOKEN` in the host environment before starting — the bundled `.mcp.json` reads the bearer from it, and without the variable the connection will not come up. Restart the host after installing, since the MCP server loads at startup. In Claude the plugin installer clones sources from GitHub over SSH by default, so have a working SSH key or a global git URL rewrite to HTTPS in place first.

## Requirements
- Remote server: `https://api.alloy.cx/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http alloy https://api.alloy.cx/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add alloy --url https://api.alloy.cx/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alloy": {
            "url": "https://api.alloy.cx/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alloy": {
            "type": "http",
            "url": "https://api.alloy.cx/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http alloy https://api.alloy.cx/mcp
```

## When to use it
- read shared company knowledge before answering
- write a decision or spec that future agents can find
- reach CRM and internal systems through one MCP connection
- delegate a task to an Alloy cloud agent and continue from its output
- audit AI teammates, skills and workflows

## Example prompts
- Check Alloy for what we decided about this service and answer with that context
- Save the research summary to Alloy as a note for the team
- Run an Alloy operations review over skills, workflows and recent activity

## Similar
- [knowledge-synthesis](https://affpapa.org/en/nevibecode/skills/knowledge-synthesis.md) — skill · 6400 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/ar9av-llm-wiki.md) — skill · 4100 installs
- [wiki-query](https://affpapa.org/en/nevibecode/skills/wiki-query.md) — skill · 3600 installs
- [second-brain](https://affpapa.org/en/nevibecode/skills/second-brain.md) — skill · 2800 installs
- [second-brain-query](https://affpapa.org/en/nevibecode/skills/second-brain-query.md) — skill · 2500 installs
- [domain-context](https://affpapa.org/en/nevibecode/skills/domain-context.md) — skill · 2500 installs

---
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