{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-resources/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"AI Coding Agent Setup","description":"Bookable is a TMS API gateway API — one integration to access real-time availability and manage bookings across venues on any table management system.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ai-coding-agent-setup","__idx":0},"children":["AI Coding Agent Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Bookable documentation site exposes a built-in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://modelcontextprotocol.io"},"children":["Model Context Protocol (MCP)"]}," server. Connect your AI coding agent to it and it will automatically retrieve accurate information about the Bookable API — correct auth URLs, endpoint shapes, composite ID rules, error codes, and more."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP server URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://docs.bookabletech.com/mcp"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No authentication is required — the Bookable docs are public."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-mcp-server-provides","__idx":1},"children":["What the MCP server provides"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-apis"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lists available APIs with their context and purpose"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-endpoints"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns all endpoints and descriptions for a specific API"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-endpoint-info"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns parameters, security, and examples for a specific endpoint"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-full-api-description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns the complete OpenAPI description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Searches documentation and returns relevant content for a query"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-agent","__idx":2},"children":["Connect your agent"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Claude Code","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run this command in your terminal:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add bookable-docs https://docs.bookabletech.com/mcp --transport http\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," in the Claude Code CLI to verify the connection and see the list of available tools."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Cursor","disable":false},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the command palette:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["macOS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Command + Shift + P"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Windows/Linux: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ctrl + Shift + P"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Type ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Open MCP settings\""]}," and press Enter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Add custom MCP\""]}," — Cursor opens ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the following configuration and save the file:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"bookable-docs\": {\n      \"url\": \"https://docs.bookabletech.com/mcp\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Return to MCP settings and confirm the connection. Cursor will display the list of available tools."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To test, open Cursor chat in Agent mode and ask a question about the Bookable API."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"VS Code","disable":false},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the command palette:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["macOS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Command + Shift + P"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Windows/Linux: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ctrl + Shift + P"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Type ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"MCP: Add Server\""]}," and press Enter."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"HTTP\""]}," to connect to a remote MCP server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://docs.bookabletech.com/mcp"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a name for the connection (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bookable-docs"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To verify, open Chat with AI in Agent mode, select the Tools icon, and confirm the Bookable Docs MCP connection appears with its tools listed."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-connection","__idx":3},"children":["Verify the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once connected, ask your AI tool:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"What is the correct token endpoint URL for the Bookable API?\""]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It should return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://auth.bookabletech.com/oauth/token"]},". If it does, the MCP server is working correctly."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":4},"children":["Related"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Looking to give your AI agent the ability to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["call"]}," the Bookable API directly (create bookings, check availability), rather than just read the docs? See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/mcp/connection-guide"},"children":["Bookable MCP Server guide"]},"."]}]},"headings":[{"value":"AI Coding Agent Setup","id":"ai-coding-agent-setup","depth":1},{"value":"What the MCP server provides","id":"what-the-mcp-server-provides","depth":2},{"value":"Connect your agent","id":"connect-your-agent","depth":2},{"value":"Verify the connection","id":"verify-the-connection","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"seo":{"title":"AI Coding Agent Setup"}},"lastModified":"2026-03-06T19:12:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/resources/docs-mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}