# Orcabase

> Orcabase is the AI-native data platform for founders: all your business data in one place, with an AI agent that understands it.

Orcabase is a hosted product; people sign in at https://app.orcabase.co. These docs cover connecting data (PostgreSQL, BigQuery, Google Sheets, MySQL, Fivetran and file uploads), the semantic layer (data models and certified metrics), the Data Agent, dashboards, and connecting Claude or ChatGPT to Orcabase over MCP.

Every page is also available as Markdown: add `.md` to its URL (for example https://tini.so/docs/quickstart.md), or request the page with `Accept: text/markdown`. https://tini.so/llms.txt lists every page, and https://tini.so/llms-full.txt has all of them in one file.

## Get started

- [Introduction](https://tini.so/docs.md): What Orcabase is, how its pieces fit together, and where to start: connect your data, define your metrics, ask the agent and share dashboards.
- [Quickstart](https://tini.so/docs/quickstart.md): Go from your invite to a first answer, a certified metric and a shared dashboard: sign in, connect data, ask the agent and invite your team.
- [How Orcabase works](https://tini.so/docs/how-it-works.md): The architecture of Orcabase on one page: where your data lives, how it flows from your databases to answers, and what each layer does.
- [Key concepts](https://tini.so/docs/concepts.md): The words you’ll see in Orcabase, from data sources and schemas to metrics, widgets and API tokens, each explained in plain words.

## Connect your data

- [Connect your data](https://tini.so/docs/data.md): The four ways to bring data into Orcabase: connect a database, sync apps and spreadsheets, upload files, or let Orcabase host it. How to choose.
- [PostgreSQL](https://tini.so/docs/data/postgresql.md): Connect your app’s PostgreSQL database with a read-only user. Queries run live, your tables are never copied, and the password is encrypted.
- [BigQuery](https://tini.so/docs/data/bigquery.md): Connect Google BigQuery with a service account: the two roles it needs, how to create the JSON key, and what queries cost in your project.
- [Orcabase-hosted databases](https://tini.so/docs/data/hosted.md): Postgres servers and DuckDB warehouses that Orcabase runs for you: nothing to install, no passwords to manage, and a home for synced data.
- [Upload files](https://tini.so/docs/data/upload-files.md): Turn a CSV, TSV, Parquet or JSON file into a table in a few clicks: what each database accepts, the 200 MB limit, and updating uploads.
- [Sync data](https://tini.so/docs/data/sync.md): Copy data from Google Sheets, MySQL and hundreds of apps into your warehouse on a schedule: how syncs run, their statuses, and who manages them.
- [Google Sheets](https://tini.so/docs/data/google-sheets.md): Sync a Google Sheet into your warehouse: share it with Orcabase, paste the link, and every tab becomes a table that refreshes on a schedule.
- [MySQL](https://tini.so/docs/data/mysql.md): Sync tables from MySQL, MariaDB or Aurora into your warehouse on a schedule with a read-only user: setup steps, limits and how it works.
- [More apps with Fivetran](https://tini.so/docs/data/fivetran.md): Bring in Salesforce, HubSpot, Stripe, Google Ads and hundreds more through Fivetran, with a monthly allowance and table-by-table control.

## Explore & query

- [Explore](https://tini.so/docs/explore.md): Browse every schema, table and column you’ve connected, preview real rows, profile columns, and start a query or data model from any table.
- [SQL Editor](https://tini.so/docs/sql-editor.md): A scratchpad for running SQL against any data source, with autocomplete, run selection and formatting. Save what works as a query.
- [Queries](https://tini.so/docs/queries.md): Save SQL as a query, add parameters with {{ name }}, and give it a chart. How results are kept, and how metric queries differ from SQL.
- [Charts](https://tini.so/docs/charts.md): The 16 chart types, from Number and Line to Funnel and Heatmap, and how to set up their data, display and number format in Orcabase.
- [Notebooks](https://tini.so/docs/notebooks.md): Write queries and build charts in one scrolling document, add notes between them, then pin the charts to any dashboard in Orcabase.

## Metrics

- [How metrics work](https://tini.so/docs/semantic-layer.md): Why Orcabase asks you to define each number once, and how data models, metrics and metric queries fit together to keep answers consistent.
- [Data models](https://tini.so/docs/data-models.md): Describe a table once: the dimensions to group by, the measures to add up, and how it joins to others. Scaffold a model from any table.
- [Metrics](https://tini.so/docs/metrics.md): Define revenue, churn and your other key numbers once, then certify them: simple, ratio and derived metrics, formats, lineage and history.
- [Explore and query metrics](https://tini.so/docs/metric-queries.md): Ask for metrics by name, trend them by day, week or month, split and filter them, and save charts that follow the metric definitions.

## Data Agent

- [Data Agent](https://tini.so/docs/agent.md): Ask about your business in plain words and get the answer, a chart and how it got there. What the Data Agent can build, and its guardrails.
- [Set up the agent](https://tini.so/docs/agent/setup.md): Choose Orcabase AI or your own OpenRouter or Vercel AI Gateway key, pick the models your team can use, and set a step limit per question.
- [AI privacy and usage](https://tini.so/docs/agent/privacy-and-usage.md): What the AI provider sees, what it never sees, and how tokens, costs and the Orcabase AI credit are counted for your organization.

## Dashboards

- [Dashboards](https://tini.so/docs/dashboards.md): Pin charts and notes onto a free-form grid your whole team sees: add widgets, arrange them, edit charts in place and keep numbers fresh.
- [Share a dashboard](https://tini.so/docs/dashboards/sharing.md): Turn on a public link so anyone can view a dashboard, no account needed: what viewers see, what stays private, and how to stop sharing.

## Connect AI

- [Connect AI](https://tini.so/docs/connect-ai.md): Use your Orcabase data from Claude and ChatGPT over MCP: what your assistant can do, what it can’t, and how it compares with the Data Agent.
- [Set up Claude and ChatGPT](https://tini.so/docs/connect-ai/setup.md): Create an API token, then add Orcabase to Claude Code, Claude Desktop, claude.ai or ChatGPT as an MCP connector. Commands and settings included.
- [Tools reference](https://tini.so/docs/connect-ai/tools.md): Every MCP tool your AI assistant gets from Orcabase, grouped by what it does, plus what’s deliberately left out: no edits, deletes or settings.

## Workspace

- [Members and roles](https://tini.so/docs/workspace/members.md): Invite teammates with a link, choose who’s an admin, and see what each role can do. Members sign in with Google, in one or more organizations.
- [API tokens](https://tini.so/docs/workspace/api-tokens.md): Create, use and revoke the API tokens that let AI assistants reach your data. Each token belongs to one organization and is shown only once.
- [Organization and account](https://tini.so/docs/workspace/settings.md): Rename your organization, change its URL, set your name, switch between organizations, pick light or dark mode, and sign out of Orcabase.

## Reference

- [Security](https://tini.so/docs/security.md): How Orcabase keeps your data safe: read-only logins, encrypted credentials, organizations kept apart, AI guardrails and limits on every query.
- [Limits](https://tini.so/docs/limits.md): Every limit in one place: rows per query, query time, upload size, chart sampling, Data Agent steps, sync frequency and Fivetran allowances.
- [Troubleshooting](https://tini.so/docs/troubleshooting.md): Fixes for the errors people run into most: signing in, connecting data sources, queries and dashboards, metrics, the agent, syncs and MCP.
- [FAQ](https://tini.so/docs/faq.md): Short answers to common questions about Orcabase: what it is, connecting and exporting your data, the AI agent, sharing, teams and pricing.

## Optional

- [Data Agent](https://tini.so/product/agent): Ask your data anything, in plain words.
- [Metrics](https://tini.so/product/metrics): Define what your numbers mean, once.
- [Dashboards](https://tini.so/product/dashboards): Your whole business at a glance.
- [Data Warehouse](https://tini.so/product/warehouse): All your business data, one place.
- [Connect AI](https://tini.so/product/connect): Use Orcabase from Claude and ChatGPT.
- [Founder's guide to data](https://tini.so/guide): Run your company on data, in plain words.
- [Agentic data warehouse](https://tini.so/guide/agentic-data-warehouse): What it is, for a company of one.
- [Pricing](https://tini.so/pricing): Plans by team size, with every feature on every plan.
- [Data sources](https://tini.so/data-sources): Every app and database Orcabase brings data in from, and how each connects.
- [PostgreSQL](https://tini.so/data-sources/postgresql): Connect your PostgreSQL database to Orcabase with a read-only login. Ask questions in plain words and get answers, charts and dashboards. Nothing is copied.
- [Supabase](https://tini.so/data-sources/supabase): Connect your Supabase database to Orcabase with a read-only login. Ask about signups, usage and revenue in plain words, and build dashboards with AI.
- [MySQL](https://tini.so/data-sources/mysql): Sync MySQL, MariaDB or Aurora into Orcabase on a schedule with a read-only login. Ask questions in plain words, get charts and build dashboards with AI.
- [Google BigQuery](https://tini.so/data-sources/bigquery): Connect Google BigQuery to Orcabase with a read-only service account. Ask in plain words, get charts and dashboards, and keep your data in your project.
- [MongoDB](https://tini.so/data-sources/mongodb): Sync MongoDB or MongoDB Atlas into Orcabase with Fivetran and ask about users, orders and usage in plain words. Get charts and dashboards without writing code.
- [Firebase](https://tini.so/data-sources/firebase): Sync Cloud Firestore into Orcabase with Fivetran and ask about users, usage and orders in plain words. Get answers, charts and dashboards, no code needed.
- [Google Sheets](https://tini.so/data-sources/google-sheets): Sync Google Sheets into Orcabase: share the sheet, paste the link, and every tab is ready to ask about in plain words, chart and put on a dashboard.
- [Airtable](https://tini.so/data-sources/airtable): Sync Airtable bases into Orcabase with Fivetran. Ask about stock, suppliers and projects in plain words, and see them next to the rest of your data.
- [CSV and file uploads](https://tini.so/data-sources/csv): Upload CSV, TSV, Parquet or JSON files to Orcabase and ask about them in plain words. Get answers and charts, and compare exports with the rest of your data.
- [Stripe](https://tini.so/data-sources/stripe): Connect Stripe to Orcabase and ask about MRR, churn, refunds and failed payments in plain words. Get answers with charts, and build revenue dashboards.
- [PayPal](https://tini.so/data-sources/paypal): Connect PayPal to Orcabase and ask about sales, refunds and fees in plain words. See PayPal next to Stripe and your store, with charts and dashboards.
- [Paddle](https://tini.so/data-sources/paddle): Connect Paddle to Orcabase and ask about MRR, trials, refunds and revenue by country in plain words. Get charts and dashboards for your software business.
- [Chargebee](https://tini.so/data-sources/chargebee): Connect Chargebee to Orcabase and ask about MRR, churn, invoices and failed payments in plain words. Build subscription dashboards with AI, no exports needed.
- [Recurly](https://tini.so/data-sources/recurly): Connect Recurly to Orcabase and ask about trials, renewals, churn and revenue in plain words. Get answers with charts and build subscription dashboards.
- [Square](https://tini.so/data-sources/square): Connect Square to Orcabase and ask about sales by item, location and day in plain words. See in-person and online sales together, with charts and dashboards.
- [RevenueCat](https://tini.so/data-sources/revenuecat): Connect RevenueCat to Orcabase and ask about app trials, renewals, churn and revenue across iOS and Android in plain words. Get charts and dashboards with AI.
- [Shopify](https://tini.so/data-sources/shopify): Connect Shopify to Orcabase and ask about orders, best sellers, repeat customers and discounts in plain words. Get charts and build store dashboards with AI.
- [WooCommerce](https://tini.so/data-sources/woocommerce): Connect WooCommerce to Orcabase and ask about sales, products, customers and coupons in plain words. Get answers, charts and store dashboards with AI.
- [Amazon Seller Central](https://tini.so/data-sources/amazon-seller-central): Connect Amazon Seller Central to Orcabase and ask about orders, fees, stock and returns in plain words. Compare Amazon with your own store in one dashboard.
- [BigCommerce](https://tini.so/data-sources/bigcommerce): Connect BigCommerce to Orcabase and ask about orders, products, categories and customers in plain words. Get answers, charts and store dashboards with AI.
- [Recharge](https://tini.so/data-sources/recharge): Connect Recharge to Orcabase and ask about subscribers, churn, skips and cancellation reasons in plain words. See subscriptions next to your Shopify store.
- [Google Ads](https://tini.so/data-sources/google-ads): Connect Google Ads to Orcabase and ask about spend, search terms, conversions and cost per customer in plain words. See ads next to your real revenue.
- [Meta Ads](https://tini.so/data-sources/meta-ads): Connect Meta Ads to Orcabase and ask about Facebook and Instagram spend, creative and cost per customer in plain words. See ad results next to real revenue.
- [TikTok Ads](https://tini.so/data-sources/tiktok-ads): Connect TikTok Ads to Orcabase and ask about video views, spend, conversions and cost per customer in plain words. See TikTok ads next to your real orders.
- [LinkedIn Ads](https://tini.so/data-sources/linkedin-ads): Connect LinkedIn Ads to Orcabase and ask about spend, leads, audiences and cost per deal in plain words. See LinkedIn ads next to your CRM and revenue.
- [Microsoft Advertising](https://tini.so/data-sources/microsoft-advertising): Connect Microsoft Advertising to Orcabase and ask about Bing spend, search terms and cost per customer in plain words. Compare Bing with Google in one chart.
- [Pinterest Ads](https://tini.so/data-sources/pinterest-ads): Connect Pinterest Ads to Orcabase and ask about pins, saves, clicks and cost per customer in plain words. See Pinterest next to your store’s real orders.
- [Google Analytics](https://tini.so/data-sources/google-analytics): Connect Google Analytics 4 to Orcabase and ask about traffic, sources, pages and conversions in plain words. See visits next to real orders and revenue.
- [Google Search Console](https://tini.so/data-sources/google-search-console): Connect Google Search Console to Orcabase and ask about searches, clicks, rankings and pages in plain words. See which searches bring visitors who buy.
- [Mixpanel](https://tini.so/data-sources/mixpanel): Connect Mixpanel to Orcabase and ask about events, funnels, retention and feature usage in plain words. See product usage next to revenue and customers.
- [Amplitude](https://tini.so/data-sources/amplitude): Connect Amplitude to Orcabase and ask about events, retention and feature usage in plain words. See product usage next to revenue, customers and support.
- [PostHog](https://tini.so/data-sources/posthog): Connect PostHog to Orcabase and ask about events, users, funnels and feature usage in plain words. See product analytics next to revenue and customers.
- [HubSpot](https://tini.so/data-sources/hubspot): Connect HubSpot to Orcabase and ask about deals, pipeline, lead sources and conversion in plain words. See your CRM next to real revenue, with dashboards.
- [Salesforce](https://tini.so/data-sources/salesforce): Connect Salesforce to Orcabase and ask about pipeline, opportunities, win rates and forecasts in plain words. See your CRM next to billing and product data.
- [Pipedrive](https://tini.so/data-sources/pipedrive): Connect Pipedrive to Orcabase and ask about deals, stages, activities and win rates in plain words. Find where deals stall, with charts and dashboards.
- [Attio](https://tini.so/data-sources/attio): Connect Attio to Orcabase and ask about deals, companies, lists and pipeline in plain words. See your CRM next to product usage and revenue, with dashboards.
- [Close](https://tini.so/data-sources/close): Connect Close CRM to Orcabase and ask about leads, opportunities, calls and emails in plain words. See what wins deals, with charts and sales dashboards.
- [Calendly](https://tini.so/data-sources/calendly): Connect Calendly to Orcabase and ask about booked meetings, cancellations, no-shows and event types in plain words. See bookings next to deals and revenue.
- [Klaviyo](https://tini.so/data-sources/klaviyo): Connect Klaviyo to Orcabase and ask about campaigns, flows, opens, clicks and revenue in plain words. See email results next to your store’s real orders.
- [Mailchimp](https://tini.so/data-sources/mailchimp): Connect Mailchimp to Orcabase and ask about campaigns, opens, clicks and audience growth in plain words. See newsletter results next to real sales.
- [Customer.io](https://tini.so/data-sources/customer-io): Connect Customer.io to Orcabase and ask about campaigns, messages, segments and conversions in plain words. See messaging next to product usage and revenue.
- [ActiveCampaign](https://tini.so/data-sources/activecampaign): Connect ActiveCampaign to Orcabase and ask about campaigns, automations, contacts and deals in plain words. See email results next to revenue, with dashboards.
- [Intercom](https://tini.so/data-sources/intercom): Connect Intercom to Orcabase and ask about conversations, topics, reply times and ratings in plain words. See support next to product usage and revenue.
- [Zendesk](https://tini.so/data-sources/zendesk): Connect Zendesk to Orcabase and ask about tickets, reply times, satisfaction and top issues in plain words. See support next to your orders and revenue.
- [Gorgias](https://tini.so/data-sources/gorgias): Connect Gorgias to Orcabase and ask about tickets, tags, reply times and satisfaction in plain words. See support next to your store’s orders and products.
- [Help Scout](https://tini.so/data-sources/help-scout): Connect Help Scout to Orcabase and ask about conversations, reply times, tags and ratings in plain words. See support trends next to customers and revenue.
- [Freshdesk](https://tini.so/data-sources/freshdesk): Connect Freshdesk to Orcabase and ask about tickets, resolution times, agents and satisfaction in plain words. Build support dashboards with AI, no exports.
- [QuickBooks](https://tini.so/data-sources/quickbooks): Connect QuickBooks Online to Orcabase and ask about margins, costs, cash and unpaid invoices in plain words. See your books next to sales and ad spend.
- [Xero](https://tini.so/data-sources/xero): Connect Xero to Orcabase and ask about cash, invoices, bills and margins in plain words. See your books next to sales and spend, with charts and dashboards.
- [Ramp](https://tini.so/data-sources/ramp): Connect Ramp to Orcabase and ask about card spend, vendors, bills and reimbursements in plain words. See spend next to revenue, with charts and dashboards.
- [Brex](https://tini.so/data-sources/brex): Connect Brex to Orcabase and ask about card spend, expenses, vendors and teams in plain words. See spend next to revenue and your books, with dashboards.
- [Jira](https://tini.so/data-sources/jira): Connect Jira to Orcabase and ask about issues, sprints, cycle time and bugs in plain words. See engineering work next to support tickets and revenue.
- [Linear](https://tini.so/data-sources/linear): Connect Linear to Orcabase and ask about issues, cycles, projects and bugs in plain words. See your team’s work next to support and revenue data.
- [GitHub](https://tini.so/data-sources/github): Connect GitHub to Orcabase and ask about pull requests, reviews, commits and issues in plain words. See how fast your team ships, with charts and dashboards.
- [Notion](https://tini.so/data-sources/notion): Connect Notion to Orcabase and ask about the databases you share, like roadmaps, content calendars and hiring, in plain words. Get answers and dashboards.
- [Asana](https://tini.so/data-sources/asana): Connect Asana to Orcabase and ask about tasks, projects, deadlines and workload in plain words. See where work is stuck, with charts and dashboards.