Usage
MCP Usage
The MCP server exposes two tools that your agent calls automatically when you ask about Brick APIs:
search_docs
Full-text search across Brick API documentation. It returns ranked results with snippets.
Parameters:
• query: string
• limit?: number
Example: How do I create a virtual account with Brick?
get_doc
Fetches the full content of a specific documentation page by slug.
Parameters:
• slug: string
• path?: string
Example slugs:
• api-endpoints
• disbursement-apis
• authenticatio
Skills Usage
Brick Skills provide packaged workflow guidance for common integration areas:
• /brick-integration for general
Brick API setup, auth, and SDK integration patterns
• /brick-accept-payment
for Receive Money via Virtual Account, QR Code, Ewallet, and Payment Link
• /brick-payment-out
for disbursements, bank transfers, sender details, and payout testing
Skills are:
• MCP-aware: prefer live MCP lookups when the server is reachable, then fall back to bundled guidance
• self-contained: each skill carries its own fallback workflow
• hash-verified: published bundles are SHA256-verified
• multi-target: one bundle supports Claude Code, OpenAI Codex, and GitHub Copilot.
Usage Modes
| Skills Only | MCP Only | Combined |
|---|---|---|
| Use this when you cannot connect to the MCP server or prefer fully local operation. Install the hosted skills bundle locally and rely on bundled guidance. | Use this when you want pure live lookups and do not want to install local skill files. Your agent connects directly to api.onebrick.io and fetches live docs on demand. | Use both Skills and MCP together when you want workflow guidance plus live documentation access. This is the recommended setup for production use. |
Hosted Endpoints
All MCP tools and Skills bundles are served from the same domain:
/v2/mcp-server/mcp— MCP tools endpoint/v2/mcp-server/mcp/health— health check/v2/mcp-server/mcp/skills/latest.json— latest version and SHA256/v2/mcp-server/mcp/skills/manifest.json— full manifest/v2/mcp-server/mcp/skills/brick-skills-latest.tar.gz— latest bundle/v2/mcp-server/mcp/skills/brick-skills-<ver>.tar.gz— versioned bundle