Connect Querious to an AI chat
Querious provides a hosted, read-only MCP server. You can connect it to a supported AI chat and explore published datasets without installing a local database or sharing an API key.
MCP endpoint:
https://jolly-aila-viz-craft-studio-aa92eb22.koyeb.app/mcp
Before you start
- Use an AI plan and workspace that supports custom MCP connections.
- Use the Querious account that has been granted access.
- Do not enter a Supabase key, Koyeb secret, or other API key. Querious uses browser-based OAuth sign-in.
- The AI may make more than one MCP tool call for a single question. Each tool call counts toward your Querious usage limit.
ChatGPT desktop
1. Open Settings → MCP servers. 2. Select Add server. 3. Name the server Querious, choose Streamable HTTP, and paste the MCP endpoint above. 4. Save the server and restart the app when prompted. 5. Select Authenticate, sign in to Querious, review the requested access, and allow it. 6. Type /mcp in the composer and confirm that Querious is connected.
The current official OpenAI instructions are in Model Context Protocol ↗.
ChatGPT web
ChatGPT web uses remote MCP tools through plugins. Your workspace must allow plugins and custom MCP connections.
1. Open Plugins and create or add a custom MCP server connection. 2. Name it Querious and use the MCP endpoint above. 3. Let ChatGPT discover the OAuth configuration and tools. 4. Sign in to Querious and allow access. 5. Install the resulting plugin. 6. Start a new chat, type @, select Querious, and ask a specific data question.
If the custom MCP option is missing, ask the ChatGPT workspace owner to check plugin and MCP permissions. A remote MCP URL by itself does not make a web plugin available to a workspace.
Claude
1. Open Customize → Connectors. 2. Select Add custom connector. 3. Name it Querious and paste the MCP endpoint above. 4. Choose browser sign-in and automatic OAuth client registration when those options are shown. Do not add request headers. 5. Sign in to Querious, allow access, and enable the connector in a new conversation.
First test
Try these prompts in order:
1. Use Querious to list the datasets I can access. 2. Describe the fields in the country geography dataset. 3. Return five rows from the country geography dataset. 4. Explain what questions this dataset can answer without making another tool call.
The first three prompts should exercise list_datasets, describe_dataset, and run_query. The fourth checks whether the AI can reuse results already present in the conversation.
Troubleshooting
- Wrong Querious account: disconnect Querious in the AI settings, reconnect it, and choose the intended account during OAuth sign-in.
- Connected but no tools: restart the AI client or refresh the plugin tool list.
- Usage limit reached: wait for the next minute window, or for the daily reset at 00:00 UTC.
- Large analysis is incomplete: ask for a smaller date range or region, then ask the AI to combine the partial results.
- Repeated sign-in: disconnect and reconnect so the client can request fresh offline access and receive a refresh token.