Bonafide MCP Server — Setup Guide
Partner IntegrationConnect your organization’s curated knowledge base to Claude and other AI assistants over the Model Context Protocol .
| Audience | Partner integration engineers |
| Base URL | mcp.bonafide.ai |
| MCP protocol | 2025-03-26 (Streamable HTTP) |
| Document version | 1.0 |
| Date | 2026-06-02 |
| Status | Stable — additive changes only |
1. Overview
The Bonafide MCP server exposes Bonafide’s curated hospitality knowledge base — FAQs, property and destination features, policies, amenities, and official links — to AI assistants such as Claude through the Model Context Protocol (MCP) . Once connected, your assistant can answer natural-language questions about your organization and its individual properties, grounded in Bonafide’s verified content rather than the model’s training data.
It is a read-only surface that exposes exactly two MCP tools:
bonafide_query— an entity-aware natural-language query that resolves the hotel/brand you mention, fetches matching documents, scores them by relevance, and returns ranked, cited results.bonafide_search_documents— a paginated browse/filter over the knowledge base by document type and category.
Every request is scoped to your organization. A key provisioned for your organization resolves to your brand and all of its properties, and can never return another organization’s content (see Data scope & isolation).
2. What Bonafide provisions for you
Before you connect, Bonafide issues you the following. Request these from your Bonafide contact (see Contact & escalation) ahead of integration.
| Item | Description |
|---|---|
client_id required | An OAuth client identifier issued by the Bonafide authentication service (Keycloak). Prefixed bfk_, e.g. bfk_xxxxxxxx. |
client_secret required | The matching client secret. Treat it as a password — see Security & credential handling. |
| Organization scope | A server-side mapping that binds your client_id to your organization (a brand BusinessEntity, e.g. HO-XXXXXXXXXXXX). This is configured by Bonafide at provisioning time; there is nothing for you to set on your side. |
| An MCP-capable client | Claude on the web (claude.ai) with custom-connector support, or any MCP client / your own HTTP integration. See Connect from Claude and Connect programmatically. |