---
agentTools:
  projectIndex: https://onebrick.readme.io/llms.txt
---

# Installation

Set up Brick MCP by connecting your agent to the remote MCP endpoint, install Brick Skills locally for your target agent, or use both together for the recommended setup.

### 1. Install MCP Server

Add the Brick MCP server to your agent’s MCP configuration using the remote HTTP endpoint:

```json
{
  "mcpServers": {
    "brick": {
      "url": "https://api.onebrick.io/v2/mcp-server/mcp",
      "transport": "http"
    }
  }
}
```

For MCP-compatible clients that only support stdio, use a local bridge that proxies stdio to the remote HTTP MCP server. You can verify connectivity through the health endpoint:

```
https://api.onebrick.io/v2/mcp-server/mcp/health
```

A healthy server returns a JSON response including `"status": "ok"`.

<br />

***

### 2. Install Skills

Brick Skills are distributed from the same server and can be installed locally for supported agent targets. The bundle is versioned and verified with SHA256 metadata.

<br />

#### a. Claude

Download and extract the hosted bundle first, then package each skill and upload it in Claude.

(*Bash Installation*).

```
cd /tmp/brick-skills/claude/skills
zip -r brick-integration.zip brick-integration
zip -r brick-payment-out.zip brick-payment-out
zip -r brick-accept-payment.zip brick-accept-payment
```

Upload each zip in:

`Claude > Customize > Skills`

<br />

Legacy Option (*Bash Installation*).:

```
cp /tmp/brick-skills/claude/.claude/commands/*.md ~/.claude/commands/
```

> change`/tmp/brick-skills/claude/.claude/commands/` with your local path

<br />

#### b. OpenAI Codex

Codex skills are folder-based. Each skill includes a SKILL.md and supporting references

(*Bash Installation*).

```
curl -L -o brick-skills-latest.tar.gz \
https://api.onebrick.io/v2/mcp-server/mcp/skills/brick-skills-latest.tar.gz

mkdir -p /tmp/brick-skills ~/.codex/skills
tar -xzf brick-skills-latest.tar.gz -C /tmp/brick-skills
cp -R /tmp/brick-skills/codex/* ~/.codex/skills/
```

After that, the skills are available in:

```
~/.codex/skills/
```

<br />

#### c. Github Copilot

Copilot uses GitHub-native instructions, prompts, and agent skills under `.github/`.

```
mkdir -p .github/instructions .github/prompts .github/skills
cp /tmp/brick-skills/copilot/.github/copilot-instructions.md .github/copilot-instructions.md
cp /tmp/brick-skills/copilot/.github/instructions/* .github/instructions/
cp /tmp/brick-skills/copilot/.github/prompts/* .github/prompts/
cp -R /tmp/brick-skills/copilot/.github/skills/* .github/skills/
```

This installs:\
•	repo-wide Copilot instructions\
•	Brick-scoped instructions\
•	reusable prompts\
•	agent skill folders for Copilot coding agent and VS Code agent mode

<br />

### Updating Skills

Check the latest published metadata *(Bash)*:

```
curl -sSL https://api.onebrick.io/v2/mcp-server/mcp/skills/latest.json
```

<br />

Download the latest bundle (*Bash*):

```
curl -L -o brick-skills-latest.tar.gz \
https://api.onebrick.io/v2/mcp-server/mcp/skills/brick-skills-latest.tar.gz

mkdir -p /tmp/brick-skills
tar -xzf brick-skills-latest.tar.gz -C /tmp/brick-skills
```

<br />

The metadata includes both package\_version and bundle SHA256, so you can detect refreshed bundles even when the version number does not change.