Autario
Official# autario-mcp
<!-- INTRO:START -->
<!-- generated by scripts/check-readme-sync.js from backend/data/entityDescription.json + the hosted server tool list | do not edit manually | run `npm run build-readme` -->
autario is data app infrastructure: your tools and thousands of public datasets in one normalized layer, and the report your AI builds on top of it runs here on a link you share.
**Connect your platforms, then let your assistant interpret the numbers.** Connect your ad accounts, your shop, your web analytics, your social profiles, your CRM and your finance tools on autario once. Through this MCP server your assistant reads those tables, joins them and explains what moved: spend, revenue and ROAS per channel, the audience behind a traffic change, the posts that worked. The public catalogue (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC) sits next to your own data as context, so a sales dip can be read against inflation or market growth in the same answer.
- **Brands and instances.** Group connected accounts by brand, and pick which accounts (instances) a report reads, so an agency asks about one brand without another brand's numbers in the answer.
- **Numbers the model does not make up.** Report tools return what autario computes server-side from your own tables, and every public value cites its primary source, so the model explains figures instead of recomputing or guessing them.
- **83 tools, each marked read or write.** The Access column in the Tool Reference below comes from each tool's own annotations, so a client can allow the read tools and ask before a write.
- **Remote or local, one tool list.** Point any HTTP MCP client at `https://autario.com/mcp` with no install, or run it over stdio with `npx autario-mcp`. The stdio package is a thin bridge to that same server: it loads the tool list at start, so new and improved tools arrive without updating the package.
<!-- INTRO:END -->
[autario.com](https://autario.com/?utm_source=mcp_readme&utm_medium=hero&utm_campaign=marketplace) | [Developer docs](https://autario.com/developer/docs?utm_source=mcp_readme&utm_medium=hero&utm_campaign=marketplace) | [Get an API Key](https://autario.com/account?utm_source=mcp_readme&utm_medium=hero&utm_campaign=marketplace&tab=apikeys)
## Why autario-mcp
- **Your platforms, not just public data.** Ads, shop, analytics, social, CRM and finance connectors land in tables your assistant can query, join and compare, and `marketing_report`, `social_360` and the other report tools return the same numbers the app shows.
- **No hallucinated numbers.** Every value is sourced from a known publisher and cited back to a primary URL. Use `verify_value` to double-check any claim.
- **Cross-dataset joins, no setup.** Indicators across different datasets share `autario_time` + `autario_entity` shadow columns, so `get_entity_data(USA, [gdp, unemployment, life_expectancy])` returns one wide table, joined automatically.
- **Statistical primitives built-in.** `correlate`, `regression`, `find_drivers`, `lag_analysis`, `seasonality_decomposition` and more, with effect sizes, p-values, and plain-language interpretations.
- **Charts that persist.** `publish_chart` writes a Plotly spec to autario.com. The result is a permanent, embeddable URL like `autario.com/chart/{slug}` | the LLM builds the spec, autario pulls real rows for it, no hallucinated data path.
- **LLM-agnostic.** Works with Claude, GPT, Gemini, local models | anything that speaks MCP.
## Quick Demo
Install the server, then ask your assistant questions like these. The model picks the right tools and answers with cited data.
```text
Ask: "Why did ROAS drop last week for this brand? Compare Meta Ads and Google Ads
against Shopify revenue."
Tools: get_my_workspace -> marketing_report
Output: Spend, revenue and ROAS per channel against the previous period, from the
connected accounts of that brand only.
```
```text
Ask: "What drives US inflation? Look at money supply, oil prices, and unemployment."
Tools: list_indicators -> find_drivers
Output: Ranked drivers with r, p-value, R squared per candidate.
```
```text
Ask: "Compare life expectancy in Germany, USA and Japan from 2000 to 2023, then publish a chart."
Tools: compare_entities -> publish_chart
Output: Wide-format table joined on year, plus a permanent autario.com/chart/{slug} URL.
```
```text
Ask: "Is consumer confidence a leading indicator of US retail sales?"
Tools: lag_analysis
Output: Cross-correlation peak at lag k, with interpretation in months.
```
```text
Ask: "Find a dataset on unemployment, build me a small app that charts it for
Germany, publish it as unlisted and give me the link."
Tools: search_datasets -> get_dataset_schema -> create_app ->
update_app_manifest -> upload_app_bundle -> get_app_preview_url -> publish_app
Output: A live URL you own. No review queue, no waiting list, nobody to ask.
```
## Install
### Claude Desktop, Cursor, Cline (stdio)
`~/.config/claude/claude_desktop_config.json` on Mac/Linux, `%APPDATA%\Claude\claude_desktop_config.json` on Windows.
```json
{
"mcpServers": {
"autario": {
"command": "npx",
"args": ["autario-mcp"]
}
}
}
```
Restart your client. On launch the package connects to `https://autario.com/mcp` and prints one line to stderr: the tool count and whether it is signed in with your API key.
**The package updates itself.** Since 3.0.0 `autario-mcp` carries no tool of its own: it is a small bridge that loads the tool list from the hosted server at start and forwards every call there. New tools and improved descriptions reach you with the next restart of your client, without `npm update`. It needs a network connection; offline, it prints one line saying so and exits.
### Claude Web, OpenAI Custom GPTs, any HTTP MCP client
Point your client at the hosted endpoint. No install needed.
```text
URL: https://autario.com/mcp
Transport: Streamable HTTP (POST /mcp)
```
The hosted endpoint also supports MCP prompts: `analyze-dataset`, `create-chart`, `compare-countries`.
### Enable your own data and the write tools
Add API credentials to the stdio config or send them as `x-api-key` / `x-api-secret` headers to the HTTP endpoint. The stdio package sends them as those same headers, and every tool then runs as you. A key the server does not accept stops the start with one line that says so.
```json
{
"mcpServers": {
"autario": {
"command": "npx",
"args": ["autario-mcp"],
"env": {
"AUTARIO_API_KEY": "your_key",
"AUTARIO_API_SECRET": "your_secret"
}
}
}
}
```
Get keys at [autario.com/account](https://autario.com/account?utm_source=mcp_readme&utm_medium=install&utm_campaign=marketplace&tab=apikeys).
## Your own data: connectors
Ask your assistant about your own accounts, not only public statistics. A connector reads one service read-only into private tables you own; the assistant reads those tables with the same tools it uses for the public catalog.
Connector families: ads (Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Advertising, Pinterest, Snapchat, Reddit, Amazon Ads), shops and marketplaces (Shopify, WooCommerce, Shopware, Magento, BigCommerce, Amazon, eBay, Etsy and more), web analytics and search (Google Analytics, Search Console, Bing Webmaster Tools, Plausible, Matomo, PostHog), social (Facebook Pages, Instagram, LinkedIn, YouTube, TikTok, Threads), email, support and reviews (Klaviyo, Mailchimp, Zendesk, Trustpilot), CRM and finance (HubSpot, Salesforce, Stripe, Wise, invoicing tools) and AI usage (OpenAI, Anthropic and others). The full, current list with one page per connector: [autario.com/connectors](https://autario.com/connectors?utm_source=mcp_readme&utm_medium=connectors&utm_campaign=marketplace).
Three steps:
1. Connect a service on its page, for example `https://autario.com/connectors/shopify`: sign in or paste a key, tick the reports you want. The first refresh starts right away and then runs daily.
2. Add autario to your assistant once: `claude mcp add autario --transport http https://autario.com/mcp`, or a custom connector with that address in Claude or ChatGPT, or the stdio config above with your API key.
3. Ask in plain words, for example "Which products sold the most units on Shopify last month, and how much revenue did each bring in?"
Behind that question the assistant calls `list_connectors` (what is connected, one `dataset_id` per report), `get_dataset_schema` (the columns and what each one means) and `query_dataset` (only the rows and columns the question needs). Nothing in a connector writes to the connected account.
## Tool Reference
<!-- TOOLS:START -->
<!-- generated by scripts/check-readme-sync.js from the hosted server tool list | do not edit manually | run `npm run build-readme` after changing a tool -->
_83 MCP tools, organized by function. This table is a snapshot of the hosted server; `npx autario-mcp` always lists the server's current tools._
### Discovery & Query
Search the catalog, inspect schemas, pull rows.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `search_datasets` | read | Search the Autario data catalog by keyword \| thousands of normalized public datasets from World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census and SEC, plus your own uploads and connector tab... | query (string), category (string), visibility (string), limit (number), page (number), format (string) |
| `discover_by_topic` | read | Discover the most relevant verified datasets for a given topic, across the public autario catalog (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC). Use this when starting an articl... | **topic** (string), depth_pref (string), recency_window (string), limit (number) |
| `list_indicators` | read | Browse the Autario indicator registry, the semantic layer over the whole public catalog (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC). Each indicator has a topic (economy, healt... | topic (string), unit (string), frequency (string), entity_type (string), publisher (string), search (string), limit (number) |
| `get_entity_profile` | read | Get the indicators available for one entity (country, aggregate, etc.). Returns indicator IDs with metadata + time coverage, sorted by observation count, PAGINATED (default 100 per call) with total... | **entity_id** (string), topic (string), limit (number), offset (number), format (string) |
| `get_dataset_info` | read | Get full metadata for a specific dataset including title, description, publisher (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC, or your own connector), category, keywords, row co... | **dataset_id** (string), format (string) |
| `get_dataset_schema` | read | Get the column names, data types, total row count, AND a machine-legible `datasheet` for a dataset. Always call this before query_dataset (to know the columns) and before charting (the datasheet te... | **dataset_id** (string), format (string) |
| `query_dataset` | read | Query the rows of ONE dataset \| a public table from World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census or SEC, or one of your own uploads / connector tables (Google Search Console, GA4, Met... | **dataset_id** (string), limit (number), offset (number), fields (string), sort (string), filter (array), aggregate (string), groupby (string), summary_only (boolean), non_null_only (boolean), overlay (string), format (string) |
| `list_charts` | read | List published chart visualizations on Autario, built on the public catalog (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC) and rendered with Plotly. Returns chart IDs, titles, insights, linked d... | q (string), limit (number), offset (number), format (string) |
| `get_chart` | read | Get a specific chart by ID or slug. Returns a COMPACT, token-bounded summary (NOT the raw Plotly spec or full data arrays, which can be megabytes): title, insight/narration, datasets_used (with pub... | **chart_id** (string), format (string) |
| `chart_instructions` | read | Get the Builder spec schema reference. Returns chart_type enum, required/optional fields per type, palette options, axis-override shape, annotation format, and concrete examples. Call this ONCE at... | _none_ |
### Cross-Dataset Joins (Ontology)
The differentiator. Join indicators across datasets via shared time + entity shadow columns. No manual relationship setup.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `get_entity_data` | read | Fetch data for ONE entity across MULTIPLE indicators, joined automatically on time via shadow columns, even when the indicators come from different publishers (World Bank GDP next to FRED unemploym... | **entity_id** (string), **indicators** (array), time (string), full (boolean), format (string) |
| `compare_entities` | read | Compare ONE indicator across MULTIPLE entities (e.g. World Bank GDP of DEU vs USA vs CHN, or a FRED / Eurostat / OECD series across countries). BY DEFAULT returns a per-entity summary (first/latest... | **entities** (array), **indicator** (string), time (string), full (boolean), format (string) |
| `verify_value` | read | Verify that a claimed value is correct against the primary source (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC). Use this when a user asks "did you hallucinate that?" or when yo... | **indicator** (string), **entity** (string), **time** (string), expected (number) |
### Statistical Analysis
Run analyses against verified data. Outputs include effect sizes, p-values, and plain-language interpretations.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `describe` | read | Summary statistics for a single indicator+entity: n, mean, median, std, min/max, quartiles, skew, histogram. Use FIRST before running any test so you know what the data looks like (sample size, com... | **indicator** (string), **entity** (string), time (string) |
| `correlate` | read | Compute Pearson + Spearman correlation between two indicators for one entity. Returns r, p-value, n, and human-readable interpretation. Use for "does X move with Y?" questions. Includes causation d... | **entity** (string), **a** (string), **b** (string), time (string), full (boolean) |
| `regression` | read | Linear regression of y ~ x for one entity. Returns slope, intercept, R² and interpretation. Use for "how does X predict Y?" questions. Runs on any verified autario indicator (World Bank, FRED, Euro... | **entity** (string), **y** (string), **x** (string), time (string), full (boolean) |
| `pct_change` | read | Period-over-period percentage change for an indicator. Use for growth rates (YoY, QoQ, MoM) \| "how fast did German GDP grow", "what is US CPI doing month over month". Runs on any verified autario i... | **entity** (string), **indicator** (string), time (string), period (string), full (boolean) |
| `rolling_stats` | read | Rolling window statistics (mean/std/min/max/sum) for an indicator. Smooths noise, reveals trends \| use it before claiming a turning point in a monthly FRED or Eurostat series. Runs on any verified... | **entity** (string), **indicator** (string), window (number), op (string), time (string), full (boolean) |
| `calculate` | read | Create a derived series from two indicators using an Excel-style op: ratio (A/B), ratio_pct (A/B*100), diff (A-B), sum (A+B), product (A*B). Returns the per-timepoint result + summary. Use for thin... | **a** (string), **b** (string), **entity** (string), op (string), time (string), override (boolean), reason (string), full (boolean) |
| `lag_analysis` | read | Cross-correlation at multiple lags. Answers "does A lead or lag B?". Peak \|r\| at positive lag means A precedes B by that many periods. Common use: "is consumer confidence a leading indicator of ret... | **a** (string), **b** (string), **entity** (string), max_lag (number), time (string) |
| `seasonality_decomposition` | read | Additive decomposition Y = trend + seasonal + residual. Use this to strip the seasonal cycle from a series and reveal the underlying trend \| great for monthly or quarterly data (retail sales, unemp... | **indicator** (string), **entity** (string), period (number), time (string), full (boolean) |
| `find_drivers` | read | Rank candidate drivers of a KPI one at a time: given a target indicator + multiple candidates, order them by correlation strength. Perfect for "what moves my KPI?" questions. Returns ranked list wi... | **entity** (string), **target_indicator** (string), **candidates** (array), time (string) |
| `decompose_drivers` | read | CONFOUNDER-AWARE DRIVER ANALYSIS: fits ONE multiple regression of the target on ALL candidates jointly, so each effect is estimated holding the other candidates constant. Distinguishes "it was the... | entity (string), **target_indicator** (string), **candidates** (array), time (string), max_lag (number) |
| `what_matters` | read | Answer "what explains this?" in one call: given an outcome metric + entity, rank which other metrics best explain the outcome. Auto-selects candidates from the ontology if `candidates` is omitted (... | **entity** (string), **outcome** (string), candidates (string), time (string) |
### Live Markets
Current quotes, SEC fundamentals, point-in-time history for backtests and daily screens (growth, value, 52-week range, 200-week moving average) for public companies. Beats stale training-data answers.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `get_company_snapshot` | read | Get current stock metrics for a public company, from live market data joined with its SEC filings. Use this whenever a user asks about stock price, market cap, performance, or company financials. R... | **ticker** (string), metrics (array) |
| `get_company_fundamentals` | read | Get a company's fundamentals and price history over time, POINT-IN-TIME correct, for backtests and trend questions. Each SEC figure (revenue, net income, cash flow, balance sheet, EPS, dividends) a... | **ticker** (string), metrics (array), window (string), interval (string) |
| `screen_stocks` | read | Screen and rank the covered US companies (and the other stocks with a daily price series) by fundamentals and price technicals, from daily snapshots built on SEC filings and adjusted daily closes.... | preset (string), filters (object), sort (string), order (string), limit (number), as_of (string), format (string) |
### Investor Portfolios (SEC Form 13F)
What well-known investors hold, from their quarterly Form 13F filings: holdings, moves, and who holds a company. Positions are as of the quarter end, filed up to 45 days later.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `list_investors` | read | List the well-known investors whose SEC Form 13F portfolios autario tracks (Berkshire Hathaway, Bridgewater, Pershing Square, Scion, Renaissance, ARK and more), with the latest reported quarter end... | format (string) |
| `get_investor_portfolio` | read | Get every position one investor reported on SEC Form 13F for a quarter: CUSIP, issuer, class, value in USD, shares, weight in the reported portfolio, change in shares against the prior quarter, new... | **investor** (string), quarter (string), limit (integer), format (string) |
| `who_holds` | read | Which of the investors autario tracks hold a company, from their latest SEC Form 13F: value in USD, shares, weight in each portfolio and the change in shares against the prior quarter. Works for co... | **ticker** (string), format (string) |
### Politician Trades (US House)
Stock trades of US House members from their Periodic Transaction Reports (STOCK Act): per member, per stock, amounts as the official ranges. Reports lag up to 45 days; Senate trades are not included.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `list_politicians` | read | List the members of the US House of Representatives who filed Periodic Transaction Reports (STOCK Act stock trade disclosures published by the Clerk of the US House), with their number of reported... | format (string) |
| `get_politician_trades` | read | Get the stock trades one US House member reported on Periodic Transaction Reports (published by the Clerk of the US House): transaction date, notification date, filing date, owner (self, spouse, jo... | **politician** (string), window (string), limit (integer), format (string) |
| `congress_trades` | read | Which US House members traded a stock, from their Periodic Transaction Reports (Clerk of the US House): member, date, purchase or sale, owner and official amount range, with totals of members, purc... | **ticker** (string), window (string), limit (integer), format (string) |
### Connectors (requires AUTARIO_API_KEY)
Hosted, auto-refreshing REST-API tables. The account owner sets a connector up in the Autario UI; agents list them, read their health (is the data fresh, which reports arrived, who has to act) and ask for a new run. Agents never change the configuration or handle credentials.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `list_connectors` | read | List the platform connectors set up on this Autario account: search, web and product analytics, ads, social, commerce, payments, AI usage and developer platforms. The answer names each connected pl... | _none_ |
| `get_connector_status` | read | Explain the state of ONE connected platform (Search Console, Shopify, an ads account, an AI usage bill): is its data fresh, which reports arrived, which came back empty because the account has no s... | **connector_id** (string) |
| `refresh_connector` | write, destructive | Pull the latest numbers from one connected platform right now and refresh its hosted Postgres table on Autario. Works for whatever that connector is for, whether it is Search Console, Shopify, an a... | **connector_id** (string) |
### Charts on Demand
Browse datasets that want a chart and request one for a dataset.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `list_chart_candidates` | read | AUTARIO-INTERNAL chart queue (admin only): list catalog datasets (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC) that have NO published chart yet, ranked by relevance, so the content pipeline can... | limit (number) |
| `request_chart` | write | AUTARIO-INTERNAL high-level chart request (admin only): the server builds the Plotly chart from a catalog dataset (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC), you do NOT build a spec, but you... | dataset_id (string), query (string), insight (string), chart_type (string), region (string), time (string) |
### Data Apps
Run an autario data-app and get a verifiable result + the live interactive chart (shareable URL + embeddable iframe). Navigate app-first: `get_my_workspace` (every app YOU use, one call) -> `get_app_context` (one app's data map incl. its KPI catalog, agent_surface) -> `get_app_artifact` (the exact saved view) ground the assistant in the same data the user sees. `audience_360` returns the caller's own computed audience report, section-selective.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `list_apps` | read | List the autario data apps (the app catalog): id, name, what each app does, its live page URL, and data_scope (private = the app works on the caller's own connected data from Google Search Console,... | format (string) |
| `get_my_workspace` | read | YOUR data-app workspace in ONE call: every autario app the calling user built, activated or connected, each with its platforms (Google Search Console, GA4, Google Ads, Meta Ads, YouTube, TikTok, In... | format (string) |
| `get_app_context` | read | The data map behind ONE autario app, so you can query app-first instead of guessing across thousands of datasets. Returns the app manifest (what it consumes, which connector providers it reads \| Go... | **app_id** (string), format (string) |
| `get_app_artifact` | read | Load ONE saved artifact from an autario data app \| the EXACT view state the user saved there (a saved SEO 360 / Audience 360 / Social 360 / AI Visibility 360 report configuration, a Plotly chart sp... | **app_id** (string), **slug** (string), format (string) |
| `audience_360` | read | Audience 360 \| the caller's OWN audience report over their connected Google Search Console + GA4 + social (Facebook Page, Instagram, TikTok) connector data, computed deterministically server-side (... | sections (array), range (string), from (string), to (string), channel (string), countries (string), brand_term (string), brand (string), instances (string), format (string) |
| `seo_360` | read | SEO 360 \| the caller's OWN deterministic Google Search Console ACTION report, computed server-side from their connected GSC data (the exact numbers the user sees in the app \| nothing re-derived, no... | sections (array), days (integer), brand (string), instances (string), format (string) |
| `content_360` | read | Content 360 \| the caller's OWN page-family report, computed server-side from their connected Search Console, GA4 and Bing Webmaster tables (the exact numbers the user sees in the app, nothing estim... | sections (array), days (integer), brand (string), instances (string), format (string) |
| `social_360` | read | Social 360 \| the caller's OWN deterministic social performance report over their connected Facebook Page, Instagram, TikTok, YouTube, LinkedIn and Threads data, computed server-side (the numbers th... | sections (array), days (integer), sort (string), brand (string), instances (string), format (string) |
| `ai_visibility_360` | read | AI Visibility 360 \| the caller's OWN brand-visibility report across the AI assistants (ChatGPT, Claude, Gemini, Perplexity, optionally Grok/DeepSeek/Mistral), read deterministically from stored run... | brand (string), sections (array), days (integer), format (string) |
| `ai_visibility_prompts` | write, destructive | AI Visibility 360 \| manage the PROMPT LIST and the assistant selection of the caller's OWN brand, read and written through the same doors the setup page clicks (no second implementation of anything... | action (string), **brand** (string), prompts (array), ids (array), assistants (array), format (string) |
| `marketing_report` | read | Marketing Report \| the caller's OWN brand marketing report, read deterministically from the derived `marketing_daily` table server-side (the exact numbers the user sees in the app \| nothing re-deri... | sections (array), brand (string), client (string), period (string), from (string), to (string), instances (string), format (string) |
| `projects` | write | Projects \| the caller's OWN project board with its objectives and key results, read and written deterministically (no LLM on this path): what a team agreed to achieve, what it works on, who works o... | action (string), group (string), id (string), title (string), brief (string), kind (string), stage (string), owner (string), contributors (array), country (string), function (string), resources_url (string), status (string), progress_pct (integer), key_result_id (string), objective_id (string), commitment (string), starts_on (string), ends_on (string), target (number), target_reason (string), baseline (number), unit (string), direction (string), manual_value (number), dataset_id (string), value_column (string), filter_column (string), filter_value (string), guards_id (string), guardrail_note (string), aggregation (string), country_column (string), country_values (array), sort (string), started_at (string), target_date (string), parent_id (string), budget_amount (number), budget_currency (string), spent_amount (number), effort_days (number), impact (integer), format (string) |
| `bubble_or_not` | read | Bubble Or Not? \| Check whether a public US stock's price is running ahead of (or backed by) its fundamentals. Overlays the share price against ONE SEC-reported fundamental (Revenue, Net Income, Dil... | **ticker** (string), metric (string), range (string), chart_type (string), scale (string) |
### Build and Ship a Data App (requires AUTARIO_API_KEY)
Build an app that runs ON autario and publish it yourself on a paid plan: a content check runs on every publish and a store listing gets one AI content review per version, synchronously, no queue. The path is create_app -> update_app_manifest -> upload_app_bundle (or write_app_artifact) -> get_app_preview_url -> publish_app, and every response carries a `next_step`. Each tool is a thin wrapper over the same REST endpoint an outside developer calls directly, so an agent is exactly its owner and never more.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `create_app` | write | Create a data app on autario in ONE call, owned by you. You give it a name and an entry: either an https URL where the app already runs, or the app itself which autario then hosts and serves inside... | **name** (string), tagline (string), entry_kind (string), entry_url (string), content (string), files (array), content_type (string), source_url (string), datasets (array), shelf (string) |
| `update_app_manifest` | write | Update the manifest of an app YOU own: its name, tagline, entry URL, version, source repository and the autario datasets or operations it is allowed to read (consumed_datasets, which is what the sa... | **app_id** (string), name (string), tagline (string), entry_url (string), version (string), source_url (string), consumed_datasets (array), tier (integer), shelf (string), datasets_owned (array), share (object) |
| `upload_app_bundle` | write | Upload or replace the code of an app YOU own: one entry document (content: HTML or JavaScript, max 512 KB), or a bundle of files (files: index.html plus the JavaScript, CSS, images, fonts and furth... | **app_id** (string), content (string), files (array), content_type (string), version (string) |
| `write_app_artifact` | write | Save an ARTIFACT into an app: the app's own output or saved state, owned by you. An artifact is what get_app_artifact reads back later \| a Plotly chart specification, a saved report configuration,... | **app_id** (string), artifact_id (string), type (string), title (string), spec (object), data (object), visibility (string) |
| `get_app_preview_url` | read | The link to OPEN an app you own, plus where it stands. Returns preview_url (a private, never-indexed page where only you can run the app, reading World Bank, FRED, Eurostat or your own connector da... | **app_id** (string) |
| `publish_app` | write | Publish an app YOU own, on a paid plan: on Free an app stays private and this answers 402 plan_required with the upgrade link. Two ways to publish: "public" gives it a tile in the autario app store... | **app_id** (string), visibility (string) |
| `unpublish_app` | write, destructive | Take an app YOU own back to private: it leaves the autario app store, its public URL stops working for everyone else, and only you can still open it at its preview URL, where it keeps reading World... | **app_id** (string) |
| `delete_app` | write, destructive | Delete an app YOU own, for good: its code (every uploaded file), its manifest, its saved artifacts, what each viewer saved in it (per-viewer state and images), its share links, team roles on it and... | **app_id** (string), **confirm** (boolean) |
### Write (requires AUTARIO_API_KEY)
Publish charts, create + populate datasets. Get keys at [autario.com/account](https://autario.com/account?tab=apikeys&utm_source=mcp_readme&utm_medium=write_section&utm_campaign=marketplace).
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `create_chart_from_spec` | write | PREFERRED chart-creation path, for any autario dataset (World Bank, FRED, Eurostat, OECD, SEC, or your own upload / connector table). Send a structured Builder spec (chart_type + x_col + y_col[s] +... | **builder_spec** (object), title (string), insight (string), narration (string), **dataset_ids** (array) |
| `publish_chart` | write | Publish a chart via freeform Plotly spec. Use create_chart_from_spec instead unless you need a Plotly feature the Builder spec doesn't cover (custom shapes, multi-axis layouts, animation frames). R... | **title** (string), plotly_spec (object), insight (string), narration (string), **dataset_ids** (array) |
| `update_chart` | write, destructive | Update an existing chart you own. Only the API key that created the chart can update it. Use this to modify the Plotly spec, title, or insight of a previously published chart. | **chart_id** (string), **plotly_spec** (object), title (string), insight (string), narration (string) |
| `create_dataset` | write | Create a new empty dataset on Autario, alongside the public catalog (World Bank, FRED, Eurostat, OECD, SEC) but private to you unless you set is_public. Returns a dataset_id you can populate with w... | **title** (string), description (string), category (string), is_public (boolean) |
| `write_rows` | write | Append rows of data to an existing dataset you own (from create_dataset) \| your own numbers, a derived table you computed, or a series you scraped together from World Bank / FRED / Eurostat results... | **dataset_id** (string), **rows** (array) |
| `clear_rows` | write, destructive | Delete all rows from a dataset you own while keeping the schema and columns intact. Useful for refreshing your own uploaded table before re-importing. Only your own datasets are reachable \| the pub... | **dataset_id** (string) |
| `delete_dataset` | write, destructive | Permanently delete a dataset you own, and all its data. This action cannot be undone. Only the dataset owner can delete it \| the public catalog (World Bank, FRED, Eurostat, OECD, SEC) is a permanen... | **dataset_id** (string) |
| `report_data_issue` | write | Report a data-quality problem you found in an autario dataset or chart (World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census, SEC or any other publisher in the catalog), so the engine can fix... | dataset_id (string), **finding_type** (string), severity (string), evidence (object), detail (string) |
### Edit Data Without Touching the Source (requires AUTARIO_API_KEY)
Label, group, flag, correct and map the rows of your datasets. The source rows are never overwritten: every edit lives in an overlay with its reason and who wrote it, an edit by an agent is a proposal the owner accepts or rejects, and reads default to the source (query_dataset overlay="with_overlay" merges the accepted edits in).
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `propose_column` | write | Propose a DERIVED column on one of your datasets: a value per row such as a topic, a group, a label, a campaign or a cleaned category. Use it to label or group posts, orders or campaigns. The sourc... | **dataset_id** (string), **column** (string), **values** (array), reason (string) |
| `propose_flags` | write | Flag rows (or single cells) of one of your datasets that look wrong, each with the reason ("negative spend", "duplicate of another row", "currency differs from the account"). A flag changes no valu... | **dataset_id** (string), **rows** (array), reason (string) |
| `propose_corrections` | write | Propose corrections of single cells of one of your datasets, each with a reason. The original value stays in the source and is shown next to the correction; if the provider later delivers a differe... | **dataset_id** (string), **corrections** (array), reason (string) |
| `propose_mappings` | write | Master data: propose that several source values of one column mean the same thing, as source value -> canonical value with a reason (campaign names spelled differently, SKUs across shops, channel s... | **dataset_id** (string), **column** (string), **mappings** (array), reason (string) |
| `list_proposals` | read | List the open proposals on one of your datasets (derived columns, flags, corrections, mappings), newest first, each with kind, column, before (original) and after (value), reason, who wrote it (per... | **dataset_id** (string), kind (string), limit (number), format (string) |
| `accept_proposals` | write | Accept open proposals by id, in bulk. Accepted entries are what overlay="with_overlay" reads; one accepted entry per target (a newer one supersedes the older). Accepting needs the owner's API key m... | **dataset_id** (string), **ids** (array) |
| `reject_proposals` | write | Reject open proposals by id, in bulk. A rejected entry stays in the history (list_overlays state "rejected") and never counts. Use it to withdraw your own proposals or when the user says which to r... | **dataset_id** (string), **ids** (array) |
| `list_overlays` | read | List the overlay layer of a dataset you can read: the ACCEPTED derived columns, flags, corrections and mappings (default), each with before/after, reason, who and when. The owner may also ask for s... | **dataset_id** (string), state (string), kind (string), limit (number), format (string) |
| `remove_overlay` | write, destructive | Remove ONE overlay entry (a derived value, flag, correction or mapping) by id. Only the overlay entry goes; the source rows are never touched. Removing an ACCEPTED entry needs the owner in the brow... | **dataset_id** (string), **id** (number) |
### Admin
Curator-only; invisible to other callers.
| Tool | Access | What it does | Parameters |
| --- | --- | --- | --- |
| `get_traction_overview` | read | ADMIN/CURATOR ONLY, autario's own traction. ONE report uniting the three real signal sources: real human reach (GA4-humans), the MCP/agent channel (mcp_tool_call volume + success-rate + top tools),... | _none_ |
| `get_engine_report` | read | ADMIN/CURATOR ONLY, autario's own ingest engine. The machine-readable health of the pipeline that pulls World Bank, FRED, Eurostat, OECD, WHO, IMF, ECB, US Census and SEC into the catalog, in ONE s... | trends (boolean), trend_days (integer), format (string) |
| `connector_health` | read | ADMIN/CURATOR ONLY, the health of every connector autario offers. ONE row per gallery connector: provider, title, logo_url, auth_kind (oauth \| key \| none), access (the OAuth login state: public \| t... | status (string), format (string) |
| `outreach_prospects` | write | ADMIN/CURATOR ONLY, the outreach engine's prospects (people who are NOT accounts, mailed a paced 3-step sequence from hello@mail.autario.com; spec 2026-11-08-outreach-engine). The prospects are the... | **action** (string), campaign (string), batch_size (integer), confirm_count (integer), rows (array), status (string), segment (string), country (string), variant (string), q (string), prospect_id (string), email (string), limit (integer), format (string) |
| `geo_experiment` | write | ADMIN/CURATOR ONLY, the GEO/SEO experiment ledger (spec 2026-11-08-geo-mcp-loop): the dated book of every crawler-touchable change, marker, open question and prediction, the one thing that makes a... | **action** (string), title (string), change (string), expected_effect (string), kind (string), date (string), review_after_days (integer), notes (string), url_path (string), id (integer), verdict (string), open (boolean), limit (integer), format (string) |
| `social_publish` | write | Publish the caller's OWN social drafts on the caller's OWN channels through the official APIs (spec 2026-11-09-own-channel-publish): the X account connected to this autario account (POST /2/tweets)... | **action** (string), draft_id (string), format (string) |
| `copy_experiments` | write | ADMIN/CURATOR ONLY, the copy experiments (spec 2026-11-08-copy-experiments): every mail subject autario sends is an experiment with several variants held as data. Recipients are allocated by Thomps... | **action** (string), experiment (string), variant (string), text (string), format (string) |
<!-- TOOLS:END -->
## autario.js: the data SDK inside every app
An app you ship with `create_app` or `upload_app_bundle` runs in a locked sandbox with no network. It reads data with `autario.js`, which autario inlines into every app it serves (a `<script src="https://autario.com/autario.js"></script>` tag is optional). Every call runs as the person looking at the app, with that person's role: the owner and the team members the owner invited (reader, editor, admin) see the datasets the app declares; a stranger sees public catalog data only. No key or token ever reaches the app.
```html
<script src="https://autario.com/autario.js"></script>
<script>
(async () => {
const { app, user } = await autario.ready(); // user.role: owner | admin | editor | reader | visitor; user.id is anonymous per app
const [first] = await autario.datasets(); // the datasets this app declares
const rows = await autario.query(first.id, { limit: 10, orderBy: 'date desc' });
await autario.artifacts.set('last_view', { id: first.id }); // editor or higher
})();
</script>
```
Declare the user's own tables with `create_app` `datasets: [ids]`. Full reference: [autario.com/developer/docs/autario-js](https://autario.com/developer/docs/autario-js).
## Environment Variables
| Variable | Default | Purpose |
| --- | --- | --- |
| `AUTARIO_API_KEY` | _unset_ | Your own data, connectors and the write tools. Public read tools work without it. |
| `AUTARIO_API_SECRET` | _unset_ | Companion secret for the API key. |
| `AUTARIO_MCP_URL` | `https://autario.com/mcp` | The MCP endpoint the stdio bridge connects to. Override only for your own autario server. |
| `AUTARIO_API_URL` | `https://autario.com` | An autario base URL; the bridge connects to its `/mcp`. Kept from 2.x, `AUTARIO_MCP_URL` wins when both are set. |
## Data Sources
World Bank, FRED, Eurostat, OECD, IMF, ECB, WHO, US Census Bureau, plus user-contributed datasets. Every dataset record includes a `source_url` pointing back to the primary publisher. Live catalog: [autario.com/data](https://autario.com/data?utm_source=mcp_readme&utm_medium=sources&utm_campaign=marketplace).
## Development
This package is part of the [autario monorepo](https://github.com/autario/autario). The published package is `server.js` + `bridge.js`: a stdio MCP server that proxies `initialize`, `tools/list`, `tools/call` and prompts to the hosted server. Tool definitions and handlers live only on the server (`tools.js` and its parts, served by `remote.js`), and the Tool Reference section above is generated from the list that server answers.
```bash
# regenerate the README Tool Reference from the server tool list
npm run build-readme
# verify README is in sync (used in CI)
npm run check-readme
```
## Links
- [autario.com](https://autario.com/?utm_source=mcp_readme&utm_medium=footer&utm_campaign=marketplace) | datasets, charts, ontology
- [Documentation](https://autario.com/documentation?utm_source=mcp_readme&utm_medium=footer&utm_campaign=marketplace#api-mcp) | API + MCP reference
- [Agent Guide](https://autario.com/api/v1/guide) | machine-readable description of every tool and endpoint
- [Issues](https://github.com/autario/autario/issues) | bug reports + feature requests
## License
MIT.
TDQS
Scored across 57 tools
The tools cover many distinct Autario subdomains (discovery, query, analytics, charts, apps, connectors, admin), and descriptions actively route the agent between overlapping families such as search_datasets vs list_indicators vs discover_by_topic, or find_drivers vs decompose_drivers vs what_matters. With 57 tools, several adjacent discovery, analytics, and app-report tools can still be confused without careful reading, so it is not perfect.
All names use snake_case with no camelCase or mixed casing, and most follow a verb_noun or clear noun-phrase pattern. A handful are noun-only or analysis names (projects, correlate, regression, bubble_or_not, audience_360), but the convention remains readable and broadly consistent.
57 tools is far beyond the usual 3–15 range and creates substantial selection and cognitive-load risk. Although Autario is a broad platform, many capabilities could be consolidated or split into separate servers, so the count is too high for one coherent MCP toolset.
The surface covers core lifecycle operations for datasets, charts, apps, connectors, analytics, projects, and admin reporting. A few peripheral gaps remain, such as no delete/update for charts or apps and connector creation being UI-only, but the major workflows have good coverage.