# TableCharts — Full Reference for LLMs and AI Agents

> Single-file flattened reference. Companion to /llms.txt. Crawl once,
> get everything an agent needs to use TableCharts.

TableCharts converts tabular data into live, embeddable charts and
dashboards. It is built exclusively for Agent-to-Agent workflows — there is
no human UI for end users. Other AI agents call TableCharts via REST, A2A,
MCP, or email and receive a live dashboard URL + embed iframe in one
round-trip.

- Site: https://www.tablecharts.co
- Docs: https://www.tablecharts.co/docs
- Agents hub: https://www.tablecharts.co/agents
- A2A agent card: https://www.tablecharts.co/.well-known/agent-card.json
- A2A discovery: https://www.tablecharts.co/.well-known/agent.json
- MCP server (open source): https://github.com/Browncabinet/tablecharts-mcp-server
- NPM package: https://www.npmjs.com/package/@tablecharts/mcp-server
- Status / health: GET https://xsbzchiryhqatvrzgyxm.supabase.co/functions/v1/health

## Pricing (USD)

| Tier            | Price        | Charts              | Notes                                            |
|-----------------|--------------|---------------------|--------------------------------------------------|
| Free trial      | $0           | 5 total (lifetime)  | No credit card required.                         |
| Starter bundle  | $9 one-time  | 15 (never expire)   | Best for trying the API / A2A path.             |
| Growth bundle   | $29 one-time | 60 (never expire)   | Most popular prepaid bundle.                       |
| Scale bundle    | $79 one-time | 200 (never expire)  | Heavy agent workloads.                             |
| Agency bundle   | $199 one-time| 600 (never expire)  | Teams and resellers.                               |
| Starter         | $29/mo       | 100 / month         | Overage $0.49/chart via credits.                   |
| Pro             | $79/mo       | 400 / month         | Overage $0.39/chart via credits; up to 5 seats.    |
| x402 pay-as-go  | $0.59/chart  | Per successful call | Agents pay autonomously in USDC on Base.           |

On quota exhaustion the API returns HTTP 402 with a machine-readable
invoice. The caller can settle via Stripe or USDC on Base and retry with
`X-PAYMENT` and `X-INVOICE` headers. See /x402 for the full protocol.

## Authentication

All API calls require a Bearer token:

```
Authorization: Bearer tc_live_<your_api_key>
```

Manage keys at https://tablecharts.co/dashboard/api-keys.

## Primary endpoint: generate_dashboard

`POST https://xsbzchiryhqatvrzgyxm.supabase.co/functions/v1/generate-dashboard`

Request body (provide exactly one of `data`, `csv`, or `source_url`):

```json
{
  "data": [{"month": "Jan", "revenue": 12000}, {"month": "Feb", "revenue": 18500}],
  "csv": "month,revenue\nJan,12000\nFeb,18500",
  "source_url": "https://docs.google.com/spreadsheets/d/.../edit",
  "title": "Monthly revenue",
  "chart_type": "bar"
}
```

`chart_type` is optional. If omitted, TableCharts picks the best of:
`bar | line | area | pie | doughnut | radar | scatter | stacked-bar |
stacked-area | horizontal-bar | funnel | treemap | heatmap | gauge | kpi`.

Response:

```json
{
  "ok": true,
  "dashboard_url": "https://tablecharts.co/d/abc123",
  "embed_url": "https://tablecharts.co/embed/abc123",
  "embed_iframe": "<iframe src=\"https://tablecharts.co/embed/abc123\" ... />",
  "embed_id": "abc123",
  "chart_type": "bar",
  "rows": 24
}
```

## A2A protocol

TableCharts implements A2A protocol v0.3.0. Discover the agent at:

- `GET /.well-known/agent.json` — A2A standard discovery
- `GET /.well-known/agent-card.json` — extended card with pricing + skills

Skill ID: `generate_dashboard`. Default input modes:
`application/json`, `text/csv`, `text/uri-list`, `message/rfc822`.
Default output modes: `application/json`, `text/html`.

## MCP server

Install for Claude Desktop, Cursor, VS Code, or Gemini Enterprise:

```json
{
  "mcpServers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": { "TABLECHARTS_API_KEY": "tc_live_..." }
    }
  }
}
```

Repository: https://github.com/Browncabinet/tablecharts-mcp-server
NPM: https://www.npmjs.com/package/@tablecharts/mcp-server

## Inbound email

Send a CSV/JSON attachment or a Notion/Sheets link to
`charts@tablecharts.co` from any address tied to your account. The
agent replies with a dashboard URL.

## Supported data sources

- **Notion databases** — public share URL or via Notion API integration
- **Google Sheets** — public sheet URL (auto-converted to CSV endpoint)
- **Salesforce** — OAuth 2.0 PKCE for reports and opportunities
- **CSV** — raw string or file
- **JSON** — array of row objects

## AI features

- Data cleaning (deduplication, type coercion, missing-value handling)
- Chart recommendation (picks best chart type for the data shape)
- Title generation
- Outlier detection
- Custom color palettes (Pro)

## Embeds

Every dashboard exposes a public embed URL: `https://tablecharts.co/embed/<id>`.
Embeds auto-update when the source data changes (Notion, Sheets,
Salesforce).

## Use cases for agents

- Reporting agents that summarize CRM or analytics data into a shareable URL
- Monitoring agents that need to publish a live chart and include the link in a message
- Data-orchestration agents that hand off final visualization to a specialist tool
- Customer-facing assistants that respond with a chart inline

## Billing headers

Every successful 200 OK returns `X-Chart-Billing` indicating which credit
bucket paid for the chart:

- `trial` — consumed one of the 5 free charts
- `subscription` — consumed Starter/Pro monthly quota
- `prepaid` — consumed a prepaid bundle credit
- `x402` — settled autonomously via x402

## Referral & attribution

Agents can include `X-Referral-Code` and optionally `X-Referrer-Agent-Id`
headers (or `referral_code` / `referrer_agent_id` in the JSON body) on any
generate_dashboard call. Public stats: GET
`https://xsbzchiryhqatvrzgyxm.supabase.co/functions/v1/referrals?code=<code>`.

## Brand & legal

- Org: TableCharts
- Site: https://www.tablecharts.co
- Terms: https://www.tablecharts.co/terms
- Privacy: https://www.tablecharts.co/privacy
- Contact: charts@tablecharts.co