Build with Bonafide
Two ways to integrate
Bonafide offers two integration surfaces over the same curated knowledge base. They are complementary — pick whichever fits the consuming system, or use both.
MCP server
Model Context Protocol over OAuth 2.0. Natural-language, entity-aware queries from Claude and other AI assistants.
Learn morePublic APIs
Plain HTTPS + API key. Structured JSON-LD you ingest on your own schedule — scheduled syncs, on-page embedding, search-console submission.
Learn moreDive deeper — MCP
Connect from Claude
Add Bonafide as a custom connector and let Claude handle the OAuth handshake.
Learn moreBase URL & Endpoints
The endpoints the server exposes and how each is authenticated.
Learn moreThe MCP Tools
bonafide_query, bonafide_search_documents, and bonafide_list_entities.
Learn moreConnect Programmatically
Mint a bearer token from Keycloak and speak MCP JSON-RPC directly.
Learn moreWorked Example
Entity ID shapes and full tool-call requests for your organization.
Learn moreData Scope & Isolation
How your key is bound to one brand and isolation is enforced.
Learn moreHealth & Troubleshooting
Health endpoint, error envelope, and common failure modes.
Learn moreDive deeper — APIs
Base URL & Authentication
The base URL, the two accepted auth headers, and safe key handling.
Learn moreFAQ JSON-LD Feed
The endpoint reference — parameters, request headers, and status codes.
Learn moreResponse Schemas
The bulk @graph envelope, the bare QAPage envelope, and every field.
Learn moreWorked Example
Bulk and single-property fetches with full requests and response bodies.
Learn moreCaching, ETags & Rate Limits
Conditional GETs, per-key quotas, and the payload-size guards.
Learn moreImplementation Guidance
A recommended ingestion loop, parsing rules, and on-page embedding.
Learn more