API Reference

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:

{
  "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".


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.


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


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


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/

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


Updating Skills

Check the latest published metadata (Bash):

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

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

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