Quickstart

This tutorial gets you from a fresh install of Coral, to your first SQL query.

Prefer the CLI experience? Run coral onboard for an interactive wizard that walks you through the whole setup described in this page.

1. Discover bundled sources

coral source discover

This lists the bundled sources available in your build. Coral comes with bundled sources for GitHub, Slack, Datadog, Linear, Sentry, and more.

2. Add a source

For example, add GitHub. Pass --interactive and Coral will prompt you for each required input:

coral source add --interactive github

Once connected, the source’s data is available as SQL tables. To update a source’s credentials later, run the same command again.

For scripted setups, omit --interactive and Coral reads each input from an environment variable of the same name — e.g. GITHUB_TOKEN=ghp_... coral source add github.

3. Query your data

You can now query any connected source using SQL. Use coral.tables to see all available tables:

coral sql "SELECT schema_name, table_name FROM coral.tables ORDER BY 1, 2"

Assuming you’ve connected GitHub, try listing open issues for a repo:

coral sql "
  SELECT number, title, state, created_at
  FROM github.issues
  WHERE owner = 'withcoral' AND repo = 'coral' AND state = 'open'
  ORDER BY created_at DESC
  LIMIT 10
"

Next steps

Use Coral over MCP — expose Coral to Claude Code, Cursor, or VS Code over MCP so your agent can query sources directly
Write a custom source spec — connect any HTTP API or local dataset that isn’t bundled yet
Install Coral skills — teach your coding agent how to use Coral

Installation

Use Coral over MCP

⌘I

Get started

Guides

Reference

Project

1. Discover bundled sources

2. Add a source

3. Query your data

Next steps

​1. Discover bundled sources

​2. Add a source

​3. Query your data

​Next steps

1. Discover bundled sources

2. Add a source

3. Query your data

Next steps