Documentation
AI Knowledge Connector
A read-only Model Context Protocol server that lets AI assistants answer questions about a business directly from that business’s own published knowledge — accurate, current, and grounded in the business’s own information rather than inferred from third-party sources across the open web.
What it is
Each Courtyard customer has a dedicated AI Knowledge Connector: an internet-hosted MCP server that serves the business’s own published knowledge — services, pricing, hours, availability, policies, and more — to AI assistants such as Claude and ChatGPT. The connector is read-only: it returns published information and never modifies data, takes bookings, or performs transactions.
Every connector is operated by Courtyard AI with the explicit authorization of the business it represents, and its knowledge base is kept accurate and up to date automatically.
Tools
The connector exposes two read-only tools:
| Tool | Description | Parameters |
|---|---|---|
search | Full-text search across the business’s published knowledge base. Returns ranked results, each with an id, title, url, and a text snippet. | query (required), page_slugs (optional), limit(optional, 5–20) |
fetch | Fetch the full published content of a single document by the id returned by search. Returns the id, title, full text, url, and metadata. | id (required) |
Both tools are annotated readOnlyHint: true and operate over a bounded, first-party corpus (openWorldHint: false). They follow the search/fetch contract used by ChatGPT for company knowledge and deep research, and every result carries a canonical url so answers are citable.
Authentication
None. The connector is public and read-only, so no account, login, or credentials are required to connect. It serves only information the business has chosen to publish.
Data handling & privacy
- First-party content only.The connector returns the business’s own published business information — never third-party data.
- No personal data. It exposes no customer records, personal data, or PII, and collects none from the conversation. The server logs only anonymous tool-call metadata for reliability.
- Tenant isolation. Each business is served from its own dedicated host, and a request only ever resolves to the business that owns that host.
See our Privacy Policy and Terms of Service.
How to connect
Each business’s connector lives at its own URL, following this pattern:
https://ai.<business-domain>/mcpThe transport is streamable HTTP. To add it in Claude: open Settings → Connectors → Add custom connector, paste the URL, and connect (leave the authentication fields blank). In ChatGPT, add it as an MCP connector using the same URL.
Support
Questions about a connector? Contact support@getcourtyard.ai or visit getcourtyard.ai.