Coralquery MCP

What coralquery-mcp MCP server does

The coralquery-mcp MCP server gives AI agents and coding teams access to Coral Query Plane, a paid hosted service for AI SDK data queries. It is delivered as a remote MCP endpoint rather than as a package containing the production implementation. The service exposes four structured JSON tools: source_list, query_run, schema_preview, and result_receipt.

These tools cover the main stages of a data-query workflow. source_list identifies available sources, schema_preview supports inspection before a query is sent, and query_run provides the query operation. result_receipt provides a receipt for the result. The documented service also includes usage receipts and workflow evidence intended for audit-ready operations.

How it works

Requests are sent to the hosted endpoint at https://coralquery.clauxel.com/mcp using MCP over Streamable HTTP. Calls require an HTTP bearer token in the Authorization header. The expected form is Authorization: Bearer <token>; production calls without valid access cannot use the service.

The public server card is available at https://coralquery.clauxel.com/.well-known/mcp/server-card.json. This gives MCP-aware tooling a published description of the service. The registry name listed for the endpoint is com.clauxel.coralquery/coralquery-mcp.

Setup and configuration

The coralquery-mcp MCP server is configured as a remote server, not started from this repository. To begin, open the Coral Query Plane website, select a plan, and create or request an API token. Add the MCP endpoint to a client that supports Streamable HTTP remote servers, then configure the client to send the bearer token with JSON-RPC requests.

The repository does not provide a local production binary or private service source code. It serves as public documentation and a directory-submission reference for the hosted service. No environment variable names are documented for running a local copy, and the README does not describe a local deployment path.

Tools and capabilities

• source_list: Exposes the service tool for listing available data sources.
• query_run: Exposes the service tool for running a data query.
• schema_preview: Exposes the service tool for previewing a source or query schema.
• result_receipt: Exposes the service tool for obtaining a result receipt.

The tools return structured JSON, according to the README. The service also advertises usage receipts and audit-oriented workflow evidence, which may help teams retain records around agent data-query activity.

Limitations and notes

Access is paid and production calls require a token issued through the product website. A browser visit to /mcp without authentication returns a JSON error rather than internal service details. The supplied material does not document query syntax, source types, result formats beyond structured JSON, token pricing, rate limits, or retention policies.

Client compatibility depends on support for remote Streamable HTTP MCP servers and bearer-token configuration. No named MCP client is identified in the README. The endpoint, server card, and product page are hosted externally, so using the service requires network access to Coral Query Plane.