Use MCP for live documentation lookups on demand, use Skills for local workflow guidance and fallback knowledge, or combine both so your agent gets structured workflows plus the latest Brick docs.
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 payment acceptance via Virtual Account, QRIS, 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 for the best result. Skills handle workflow guidance, while MCP provides authoritative live docs. 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