Server definition
- Hash
- sha256:429034cf27fc19161416ed2730ae03beaba2d80095d3a1e43b9c4d664218aaf7
- What it is
- What a remote MCP server returned when asked what it offers: 16 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Statistics computed server-side on verified autario indicators (World Bank, FRED, Eurostat, OECD, IMF, WHO, SEC): correlation, regression, growth, drivers, seasonality, value checks.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"a": {
"description": "correlate: First indicator ID calculate: First operand A (the numerator of a ratio). Indicator id of a numeric series, exactly as find_data action \"indicators\" or get_data action \"profile\" return it (a public indicator or one of your own uploads or connector tables). lag_analysis: First indicator id (candidate leading series)",
"type": "string"
},
"action": {
"description": "Which operation to run. describe = summary statistics and trend of one series, needs indicator, entity; correlate = correlation between two series, needs entity, a, b; regression = linear regression of y on x, needs entity, y, x; pct_change = percent change and growth over a period, needs entity, indicator; rolling_stats = rolling mean, sum or other window statistic, needs entity, indicator; calculate = arithmetic between two series, checked for compatible meaning, needs a, b, entity; lag_analysis = lead and lag between two series, needs a, b, entity; seasonality = trend, seasonal and residual parts of a series, needs indicator, entity; find_drivers = which candidate indicators move with a target, needs entity, target_indicator, candidates; decompose_drivers = share of a target's change explained by each candidate, needs target_indicator, candidates; what_matters = ranked factors behind an outcome, needs entity, outcome; verify_value = check a quoted number against the source, needs indicator, entity, time.",
"enum": [
"describe",
"correlate",
"regression",
"pct_change",
"rolling_stats",
"calculate",
"lag_analysis",
"seasonality",
"find_drivers",
"decompose_drivers",
"what_matters",
"verify_value"
],
"type": "string"
},
"b": {
"description": "correlate: Second indicator ID calculate: Second operand B (the denominator of a ratio). Indicator id of a numeric series, exactly as find_data action \"indicators\" or get_data action \"profile\" return it (a public indicator or one of your own uploads or connector tables). lag_analysis: Second indicator id (candidate lagging series)",
"type": "string"
},
"candidates": {
"description": "find_drivers: Candidate indicator IDs to test (max 30) decompose_drivers: Candidate indicator ids to decompose jointly (2-15) what_matters: Optional comma-separated candidate indicator ids. If omitted, auto-selects from ontology.",
"items": {
"type": "string"
},
"type": [
"array",
"string"
]
},
"entity": {
"description": "describe, regression, pct_change, rolling_stats, calculate, seasonality: Entity the series is read for: an ISO 3166 alpha-3 country code such as \"DEU\" or \"USA\", or an aggregate code such as \"WLD\" or \"EUU\" (the canonical name matches too). Use the codes find_data action \"indicators\" and get_data action \"profile\" accept. correlate, find_drivers: Entity code (e.g. DEU) lag_analysis: Entity code (e.g. USA) decompose_drivers: Entity code (e.g. DEU). Omit for entity-less private series. what_matters: Entity code (e.g. USA, DEU) verify_value: Entity code (e.g. DEU, USA, EUU)",
"type": "string"
},
"expected": {
"description": "The value you want to verify. Omit for existence-only check.",
"type": "number"
},
"full": {
"description": "Return the full raw time series (heavy, many tokens). Default false → you get only the summary/stats, which is enough to ANSWER a question. Set true only when you must plot or export every point.",
"type": "boolean"
},
"indicator": {
"description": "describe, pct_change, rolling_stats, seasonality: Indicator id of a numeric series, exactly as find_data action \"indicators\" or get_data action \"profile\" return it (a public indicator or one of your own uploads or connector tables). verify_value: Indicator ID",
"type": "string"
},
"max_lag": {
"description": "lag_analysis: Max lag in periods (1-20, default 5) decompose_drivers: Max lead/lag periods to scan per candidate (0 disables, default 5, max 20)",
"type": "number"
},
"op": {
"description": "rolling_stats: mean | std | min | max | sum (default: mean) calculate: ratio | ratio_pct | diff | sum | product (default: ratio)",
"type": "string"
},
"outcome": {
"description": "Indicator id of the outcome metric",
"type": "string"
},
"override": {
"description": "Compute a combination autario refused as incompatible. Requires `reason`.",
"type": "boolean"
},
"period": {
"description": "pct_change: yoy | qoq | mom (default: yoy) seasonality: Seasonal period in time steps (12=monthly, 4=quarterly, 7=weekly). Auto-inferred from indicator frequency if omitted.",
"type": [
"string",
"number"
]
},
"reason": {
"description": "Why the refused combination is correct here. Returned with the result so a human can audit the decision.",
"type": "string"
},
"target_indicator": {
"description": "The KPI you want to explain",
"type": "string"
},
"time": {
"description": "describe, regression, pct_change, rolling_stats, calculate, lag_analysis, seasonality, find_drivers, decompose_drivers, what_matters: Optional time window. \"2010-2023\" keeps 2010 through 2023, \"2019-01-2024-06\" works by month, and a single \"2015\" keeps 2015 onward. Omitted or unparseable = the whole series. correlate: Optional time range: \"2010-2023\" verify_value: Time period (e.g. \"2023\" or \"2023-06\")",
"type": "string"
},
"window": {
"description": "Window size in periods (2-100, default 5)",
"type": "number"
},
"x": {
"description": "Independent variable (predictor) indicator ID",
"type": "string"
},
"y": {
"description": "Dependent variable (target) indicator ID",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "analyze",
"outputSchema": null
},
{
"description": "The computed report of an autario data app on the caller's own connected data (Google Search Console, GA4, Instagram, Facebook, TikTok, YouTube, LinkedIn, Meta Ads, Google Ads, Shopify, ChatGPT and other assistants), or a public bubble check on a stock.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"app": {
"description": "Which operation to run. audience_360 = audience, acquisition and conversion across web and social (sign-in); seo_360 = Search Console actions: gaps, decay, cannibalization (sign-in); content_360 = which pages and posts perform (sign-in); social_360 = followers, reach, engagement and posts per channel (sign-in); marketing_report = spend, revenue and ROAS per channel for a brand (sign-in); ai_visibility_360 = how AI assistants mention your brand (sign-in); projects = your project board, grouped (sign-in); project = one project with milestones and KPIs (sign-in); project_objectives = objectives and key results with derived status (sign-in); bubble_or_not = public valuation check on a stock ticker, needs ticker.",
"enum": [
"audience_360",
"seo_360",
"content_360",
"social_360",
"marketing_report",
"ai_visibility_360",
"projects",
"project",
"project_objectives",
"bubble_or_not"
],
"type": "string"
},
"brand": {
"description": "audience_360: The brand (connector grouping) id to report on, as a uuid. Omitted means the brand selected in the autario app (the account's stored brand choice), so you see what the user sees on screen; with no brand selected, all of the account's brands. A non-uuid value is read as `brand_term` instead, so a caller written before 2026-09-22 keeps working. seo_360, content_360, social_360: The brand (connector grouping) id to report on, as a uuid. Omitted means the brand selected in the autario app (the account's stored brand choice), so you see what the user sees on screen; with no brand selected, all of the account's brands. A brand that is not yours answers an error, never another brand's numbers. marketing_report: The brand id (uuid) to report on. Omitted means the brand selected in the autario app (the account's stored brand choice); with none selected, the account's Default brand, which is where every unassigned connector already belongs. Every response lists the caller's brands, so a first call without this argument tells you what to pass next. ai_visibility_360: Brand name or brand id. Optional when the account has exactly one brand; with several brands the tool answers with the list so you can re-call with one (nothing is picked for you).",
"type": "string"
},
"brand_term": {
"description": "Optional brand TERM override for the brand-vs-generic query split (default: derived from the GSC property). Renamed from `brand` on 2026-09-22, when that word became the connector grouping everywhere; a non-uuid `brand` is still read as this.",
"type": "string"
},
"channel": {
"description": "Optional single-channel filter (sections that cannot honor it say so in notes).",
"enum": [
"ai",
"bing",
"google",
"social",
"direct",
"referral"
],
"type": "string"
},
"chart_type": {
"description": "Optional render style for the fundamental: line or bar. Default is the app's smart choice (bars for quarterly reports, line for daily-derived metrics).",
"enum": [
"line",
"bar"
],
"type": "string"
},
"client": {
"description": "Deprecated spelling of `brand`, still accepted so callers written before 2026-09-22 keep working. Pass `brand`.",
"type": "string"
},
"countries": {
"description": "Optional comma-separated ISO country codes filter, e.g. \"DEU,USA\".",
"type": "string"
},
"days": {
"description": "seo_360: Analysis window in days (7-90, default 28), anchored at the newest day of the caller's data. The trend comparison uses the same-length window before it. content_360: Analysis window in days (7, 28 or 90, default 28), anchored at the newest day of the caller's Search Console data and folded into ISO weeks. The change compares against the same-length window before it. social_360: Analysis window in days (7-90, default 28). Each platform anchors it at the newest day of ITS OWN connector table, because connectors refresh on different rhythms. ai_visibility_360: Analysis window in days over the stored runs (1-365). Omit it for every run the brand has (the default).",
"type": "integer"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"from": {
"description": "audience_360: Custom window start (YYYY-MM-DD), only with range=custom. marketing_report: Start day (YYYY-MM-DD) when period is \"custom\". An unusable pair falls back to the default window rather than erroring.",
"type": "string"
},
"group": {
"description": "For \"list\": which axis the cards are folded on. Default \"okr\", which is the axis that answers \"does everything we do pay into something we agreed\".",
"enum": [
"okr",
"country",
"function",
"person"
],
"type": "string"
},
"id": {
"description": "The id of the thing to read or change: the project for \"get\" and \"update\", the objective for \"update_objective\", the key result for \"update_key_result\".",
"type": "string"
},
"instances": {
"description": "Optional comma-separated connector instance ids, to narrow the report to some of the connections inside the selected brand (for example one of two Search Console properties). Omitted means all of them. An id that is not yours, or not in that brand, answers an error rather than a quietly shorter report. The ids are the instance ids my_workspace action \"app_context\" returns for this app.",
"type": "string"
},
"metric": {
"description": "Optional fundamental to overlay against price. One of the labels from the company's available metrics (e.g. \"Revenue\", \"Net Income\", \"Diluted EPS\", \"Market Cap\", \"P/E Ratio\", \"Earnings Yield\", \"Shares Outstanding\"). If omitted, a sensible default is chosen. The response lists available_metrics so you can re-call with another.",
"type": "string"
},
"period": {
"description": "The reporting window. Default last-30. \"this-week\" runs Monday to today and compares to the same weekdays one week earlier; \"custom\" needs `from` and `to`.",
"enum": [
"this-week",
"last-week",
"last-30",
"custom"
],
"type": "string"
},
"range": {
"description": "audience_360: Time window preset. Relative presets anchor at the newest data day. Default 90d. Use \"custom\" together with from/to. bubble_or_not: Optional time window for the chart. Default ALL (full history).",
"enum": [
"1w",
"2w",
"30d",
"90d",
"ttm",
"ytd",
"py",
"custom",
"YTD",
"1Y",
"2Y",
"5Y",
"10Y",
"ALL"
],
"type": "string"
},
"scale": {
"description": "Optional value scale. \"absolute\" = raw values on a dual axis. \"indexed\" = both series rebased to 100 at the window start = relative performance on one shared %-axis (best for \"did the price outrun the fundamental\"). Default absolute.",
"enum": [
"absolute",
"indexed"
],
"type": "string"
},
"sections": {
"description": "audience_360: Which report sections to return. Default [\"overview\",\"channels\"]. Request only what the question needs (token efficiency); call again for more. seo_360: Which report sections to return. Default [\"page2_gaps\",\"health\"]. Request only what the question needs (token efficiency); call again for more. content_360: Which report sections to return. Default [\"overview\"]. Request only what the question needs; call again for more. social_360: Which report sections to return. Default [\"score\",\"health\"]. Request only what the question needs (token efficiency); call again for more. activity = the activity table: every post with platform, content type, topic, post type, sentiment and language, per-dimension pivots and the (platform, content type, topic, language) groups that beat the platform median; labels come from the user's own classification run. marketing_report: Which report sections to return. Default [\"overview\"]. Request only what the question needs (token efficiency); call again for more. ai_visibility_360: Which report sections to return. Default [\"overview\"]. Request only what the question needs (token efficiency); call again for more. searches = the web searches the assistants ran behind their answers (grouped by topic, brands named in them); movers = cited domains that are new / trending / losing against the prior window; pages = the cited pages with what is ON them (title, page type, which tracked brands the page names); crawlability = what each domain's robots.txt says to each AI crawler (GPTBot, ClaudeBot, PerplexityBot...) plus llms.txt; perception = the descriptor words the answers use next to each brand, as a brand-by-word matrix; action_effects = the brand's visibility 14 days before and after every action marked done; gaps = the sources that cite a competitor and never this brand, with gap score, used-as-a-source share, prompt coverage and competitor rate (each defined on the page; there is deliberately no retrieval rate, because only citations are observable); model_rankings = the brands each assistant names most, as a rank order with the owned brand flagged.",
"items": {},
"type": "array"
},
"sort": {
"description": "social_360: How the cross-platform top-post list is ranked (posts section). Default engagement. The three rates rank only posts whose platform reports them (Instagram today). projects: For \"list\": the order of cards inside each group. \"board\" (default) puts off-track work first; \"effort_impact\" orders by impact (5 to 1) then effort (fewest days first), unrated work last. No combined score is computed.",
"enum": [
"engagement",
"reach",
"views",
"likes",
"comments",
"shares",
"saves",
"saveRate",
"shareRate",
"engagementRateReach",
"board",
"effort_impact"
],
"type": "string"
},
"ticker": {
"description": "US stock ticker symbol, e.g. AAPL, MSFT, NVDA, TSLA, AMZN",
"type": "string"
},
"to": {
"description": "audience_360: Custom window end (YYYY-MM-DD), only with range=custom. marketing_report: End day (YYYY-MM-DD) when period is \"custom\".",
"type": "string"
}
},
"required": [
"app"
],
"type": "object"
},
"name": "app_report",
"outputSchema": null
},
{
"description": "Change settings of the caller's autario apps: AI Visibility prompts and assistants (ChatGPT, Claude, Gemini, Perplexity), project board items, and the public developer profile.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. prompts_list = AI Visibility prompts and assistant selection of a brand, needs brand; prompts_add = store new AI Visibility prompts, needs brand; prompts_remove = set AI Visibility prompts inactive, needs brand; prompts_set_assistants = choose which assistants a brand runs, needs brand; project_create = add a project; project_update = change a project; objective_create = add an objective; objective_update = change an objective; key_result_create = add a key result; key_result_update = change a key result; developer_profile = your public developer profile.",
"enum": [
"prompts_list",
"prompts_add",
"prompts_remove",
"prompts_set_assistants",
"project_create",
"project_update",
"objective_create",
"objective_update",
"key_result_create",
"key_result_update",
"developer_profile"
],
"type": "string"
},
"aggregation": {
"description": "For key results: how its countries add up to a region. sum (default) for counts and money, average for rates and levels, none lists the countries without a total.",
"enum": [
"sum",
"average",
"none"
],
"type": "string"
},
"assistants": {
"description": "For \"set_assistants\": the full list of assistants this brand runs from now on (replaces the current selection). An empty array returns to the app default.",
"items": {
"description": "A provider id from the app registry, for example openai, anthropic, gemini, perplexity.",
"type": "string"
},
"type": "array"
},
"baseline": {
"description": "For key results: where the number started. Attainment runs from baseline to target.",
"type": "number"
},
"bio": {
"description": "Up to 280 characters about you or what you build.",
"type": "string"
},
"brand": {
"description": "Brand name or brand id (required). With several brands on the account the name must match one of them exactly (case-insensitive); the tool answers with the list when it does not.",
"type": "string"
},
"brief": {
"description": "A short description of what the project is.",
"type": "string"
},
"budget_amount": {
"description": "Budget. Needs budget_currency. Never converted between currencies.",
"type": "number"
},
"budget_currency": {
"description": "Three letter currency code of the budget, e.g. EUR.",
"type": "string"
},
"commitment": {
"description": "For objectives: committed (expected at 1.0) or aspirational (0.7 is a good outcome). Changes the status rule of its key results, never a number.",
"enum": [
"committed",
"aspirational"
],
"type": "string"
},
"contributors": {
"description": "Everyone else working on it. These names are what the person axis groups by, together with the owner.",
"items": {
"type": "string"
},
"type": "array"
},
"country": {
"description": "The region or country that runs it, in the account's own words (\"DACH\", \"Nordics\"), not an ISO code.",
"type": "string"
},
"country_column": {
"description": "For key results with dataset_id: the column that names the country of a row (autario_entity when the dataset has it). value_column is then read per country; a country the dataset lacks keeps its typed value.",
"type": "string"
},
"country_values": {
"description": "For key results: the value per country, [{ country, current, target }]; country as a name or ISO code. A region total uses these; several countries without values are never split.",
"items": {
"properties": {
"country": {
"description": "The country, as an ISO code (DEU or DE) or its English name. Listed once per key result; an unknown name is refused with a sentence.",
"type": "string"
},
"current": {
"description": "The value this country has today, in the unit of the key result. Omit when unknown; a row without current and target is dropped.",
"type": "number"
},
"target": {
"description": "The value this country should reach, in the unit of the key result. The region target is derived from these by aggregation.",
"type": "number"
}
},
"required": [
"country"
],
"type": "object"
},
"type": "array"
},
"dataset_id": {
"description": "For key results: the dataset the value is read from (any dataset on this account).",
"type": "string"
},
"direction": {
"description": "For key results: whether higher or lower is better. Default increase.",
"enum": [
"increase",
"decrease"
],
"type": "string"
},
"display_name": {
"description": "Name shown on the page, up to 60 characters. Defaults to the handle.",
"type": "string"
},
"effort_days": {
"description": "Estimated effort in person days.",
"type": "number"
},
"ends_on": {
"description": "For objectives: end of that window, YYYY-MM-DD.",
"type": "string"
},
"filter_column": {
"description": "For key results: optional column to filter the dataset on.",
"type": "string"
},
"filter_value": {
"description": "For key results: the value filter_column must have.",
"type": "string"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"function": {
"description": "The function that contributes it (\"Marketing\", \"Supply chain\").",
"type": "string"
},
"github_url": {
"description": "Your GitHub profile, on github.com.",
"type": "string"
},
"group": {
"description": "For \"list\": which axis the cards are folded on. Default \"okr\", which is the axis that answers \"does everything we do pay into something we agreed\".",
"enum": [
"okr",
"country",
"function",
"person"
],
"type": "string"
},
"guardrail_note": {
"description": "For key results: how this number could be reached the wrong way.",
"type": "string"
},
"guards_id": {
"description": "For key results: makes this key result a GUARDRAIL of that key result.",
"type": "string"
},
"handle": {
"description": "Your public handle, set once (lowercase, 3 to 30 characters). Omit it after it is set.",
"type": "string"
},
"id": {
"description": "The id of the thing to read or change: the project for \"get\" and \"update\", the objective for \"update_objective\", the key result for \"update_key_result\".",
"type": "string"
},
"ids": {
"description": "For \"remove\": the prompt ids to set inactive. An id that is not on this brand answers not found and the others still go through.",
"items": {
"description": "A prompt id as returned by action \"list\".",
"type": "string"
},
"type": "array"
},
"impact": {
"description": "Expected impact as a judgement: 1 low, 2 some, 3 clear, 4 high, 5 very high.",
"enum": [
1,
2,
3,
4,
5
],
"type": "integer"
},
"key_result_id": {
"description": "The id of the key result this project pays into. \"list\" returns the linkable ones in `key_results`; pass one of their `id` values. Omit for work that pays into nothing yet, which is exactly what the OKR axis is there to make visible.",
"type": "string"
},
"kind": {
"description": "Is this a project with an end, or recurring day-to-day work? Default \"project\".",
"enum": [
"project",
"day_to_day"
],
"type": "string"
},
"linkedin_url": {
"description": "Your LinkedIn profile, on linkedin.com.",
"type": "string"
},
"manual_value": {
"description": "For key results: the current value typed by hand. Shown as typed by hand; prefer dataset_id + value_column.",
"type": "number"
},
"objective_id": {
"description": "For \"create_key_result\": the objective it belongs to. \"objectives\" lists them.",
"type": "string"
},
"owner": {
"description": "The one person accountable for it.",
"type": "string"
},
"parent_id": {
"description": "The project this one is part of. Projects nest at most three levels deep (programme, workstream, piece); a move that would make a fourth level or a loop is refused with a sentence. Parent progress, when the parent has none of its own, is the mean of its children and says so.",
"type": "string"
},
"progress_pct": {
"description": "Progress in percent, 0 to 100, set by a person. Never derived from milestones or dates.",
"type": "integer"
},
"prompts": {
"description": "For \"add\": the prompts to store. Each item is {text, topic?, category?}. The server applies the brand rule per item and reports what it stored, what it reclassified and what it refused, with the reason.",
"items": {
"properties": {
"category": {
"description": "Optional question type. direct (default) = category buying question, never your own brand; application = a problem described in the user's words, no brand and no product category; comparison = two named options weighed, brands allowed.",
"enum": [
"direct",
"application",
"comparison"
],
"type": "string"
},
"text": {
"description": "The question exactly as a buyer would type it into an assistant.",
"type": "string"
},
"topic": {
"description": "Optional topic label the prompt is grouped under in the app (free text, for example \"Agency reporting\").",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"resources_url": {
"description": "A link to where the actual work lives (a drive folder, a board, a doc). http(s) only.",
"type": "string"
},
"sort": {
"description": "For \"list\": the order of cards inside each group. \"board\" (default) puts off-track work first; \"effort_impact\" orders by impact (5 to 1) then effort (fewest days first), unrated work last. No combined score is computed.",
"enum": [
"board",
"effort_impact"
],
"type": "string"
},
"spent_amount": {
"description": "Money spent so far, typed by a person, in budget_currency.",
"type": "number"
},
"stage": {
"description": "Where it stands. A new project starts \"active\" (running); when the board owner switched on \"New projects need admin approval\", a non-admin's new project starts at \"inbox\" (pending review) and only an admin moves it out. \"long_list\" = agreed, not started; \"done\" = finished.",
"enum": [
"inbox",
"long_list",
"active",
"done"
],
"type": "string"
},
"started_at": {
"description": "Start date, YYYY-MM-DD.",
"type": "string"
},
"starts_on": {
"description": "For objectives: start of the window its key results are paced against, YYYY-MM-DD.",
"type": "string"
},
"status": {
"description": "The traffic light, set by a person: on track, at risk, off track.",
"enum": [
"green",
"amber",
"red"
],
"type": "string"
},
"target": {
"description": "For key results: the number that counts as done. Required on create.",
"type": "number"
},
"target_date": {
"description": "Target date, YYYY-MM-DD. \"Due in N days\" / \"overdue by N days\" is derived from it on every read and never stored.",
"type": "string"
},
"target_reason": {
"description": "For \"update_key_result\": why the target moves (ten characters or more). Required whenever `target` changes; the change is kept in the key result history.",
"type": "string"
},
"title": {
"description": "Project title. Required for \"create\".",
"type": "string"
},
"unit": {
"description": "For key results: the unit the number is in.",
"type": "string"
},
"value_column": {
"description": "For key results: the column of dataset_id that holds the number.",
"type": "string"
},
"website_url": {
"description": "Your website, http(s).",
"type": "string"
},
"x_url": {
"description": "Your X profile, on x.com or twitter.com.",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "app_settings",
"outputSchema": null
},
{
"description": "Build a data app that runs on autario (HTML with the autario.js SDK on your own data), upload its code, set its manifest, save views, and publish or unpublish it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. create = a new private app, needs name; upload_bundle = replace the app's HTML or files, needs app_id; update_manifest = name, datasets, shelf, sharing, needs app_id; write_artifact = save a view or result of the app, needs app_id; publish = set visibility unlisted or public, needs app_id; unpublish = take the app back to private, needs app_id.",
"enum": [
"create",
"upload_bundle",
"update_manifest",
"write_artifact",
"publish",
"unpublish"
],
"type": "string"
},
"app_id": {
"description": "upload_bundle, publish, unpublish: Id of an app you own, as returned by apps action \"create\". An app you do not own answers not found. update_manifest: The app id returned by apps action \"create\". write_artifact: The app the artifact belongs to.",
"type": "string"
},
"artifact_id": {
"description": "Omit to CREATE. Give an existing artifact id to PATCH that one.",
"type": "string"
},
"consumed_datasets": {
"description": "What the app reads, e.g. [{\"op\":\"datasetData\",\"dataset\":\"<id>\"}]. The sandbox bridge refuses any read the manifest did not declare. To read the connected accounts of whoever opens the app, add the connector keys: [{\"op\":\"connectors\",\"providers\":[\"google_search_console\",\"ga4\"]}] | those providers then appear on the Settings tab of the app with the connection state of that viewer, so a user who has not connected one can connect it from inside the app. Add \"optional\": true and \"unlocks\":\"<what it adds>\" for a source the app works without.",
"items": {
"type": "object"
},
"type": "array"
},
"content": {
"description": "create: The app's entry document when entry_kind is \"upload\": one HTML file, or index.html when you also send files. It runs in a sandbox with no outbound network: read autario data through autario.js, not through fetch to third parties. upload_bundle: The entry document itself (one HTML file), or index.html when you also send files. Give content, files, or both.",
"type": "string"
},
"content_type": {
"description": "create: Type of the uploaded content. Default text/html. upload_bundle: Type of content when it is the only file. Default text/html.",
"enum": [
"text/html",
"text/javascript",
"application/javascript"
],
"type": "string"
},
"data": {
"description": "Optional inline data belonging to the artifact.",
"type": "object"
},
"datasets": {
"description": "Ids of the user's OWN datasets (connector tables, uploads; get them from my_workspace action \"overview\") this app may read through autario.js. Everyone the owner shares the app with (role reader and up) reads exactly these, nothing else. Public catalog datasets need no declaration.",
"items": {
"type": "string"
},
"type": "array"
},
"datasets_owned": {
"description": "Datasets the app OWNS and writes through autario.rows (insert, select, update, delete), e.g. [{\"key\":\"contacts\",\"title\":\"Contacts\",\"scope\":\"app\",\"columns\":[{\"name\":\"email\",\"type\":\"text\",\"required\":true},{\"name\":\"deals\",\"type\":\"integer\"}]}]. scope \"app\" = one table of the app kept by the owner (readers read, editors write); scope \"viewer\" = one table per person looking at the app, readable only by that person (not by the owner). Types: text, number, integer, boolean, date (YYYY-MM-DD), timestamp (ISO with a time zone). Every written row is checked against these columns. A declared column cannot change its type and a key cannot change its scope; add new ones instead. Max 20 datasets x 50 columns. Omit to keep the current declaration.",
"items": {
"type": "object"
},
"type": "array"
},
"entry_kind": {
"description": "\"url\" = the app already runs somewhere (give entry_url). \"upload\" = you are sending the app itself (give content or files). Default \"url\".",
"enum": [
"url",
"upload"
],
"type": "string"
},
"entry_url": {
"description": "create: REQUIRED when entry_kind is \"url\". Must start with https://. update_manifest: Where the app runs. An uploaded bundle uses the conventional \"index.html\".",
"type": "string"
},
"files": {
"description": "A multi-file app: index.html plus every file it loads by relative path (e.g. \"app.js\", \"css/style.css\", \"img/logo.png\", \"about.html\"). Paths are relative, use \"/\", no \"..\". Allowed: html, js, mjs, css, json, svg, png, jpg, webp, woff2. Max 50 files, 1 MB each, 2 MB in total. Put index.html in this list or pass it as content. Links between the HTML pages work, every page gets autario.js.",
"items": {
"properties": {
"content": {
"description": "The file: text as is, binary (images, fonts) as base64 with encoding \"base64\".",
"type": "string"
},
"encoding": {
"description": "Default utf8.",
"enum": [
"utf8",
"base64"
],
"type": "string"
},
"path": {
"description": "Relative path inside the app, e.g. \"js/app.js\".",
"type": "string"
}
},
"required": [
"path",
"content"
],
"type": "object"
},
"type": "array"
},
"name": {
"description": "create: Display name of the app, free text up to 80 characters; the same name as another app is fine. The returned app_id is the name lowercased plus a short random part and never changes on a rename. update_manifest: New display name. Omit to keep the current one.",
"type": "string"
},
"share": {
"description": "Let a report of this app be opened on a secret read-only link, e.g. {\"subjects\":[\"account\"],\"sections\":[\"meta\",\"report\"]}. \"subjects\" says WHOSE data a link points at and may only name kinds autario can resolve (\"account\" = the owner of the link, which is what a third-party app wants); \"sections\" is the list a link may request, and anything outside it is refused. Omit the key to leave the current setting alone. An app that has never declared this cannot be shared at all. The owner still decides per link who may open it: anyone with the URL, only signed-in people from named company domains, or only named addresses.",
"type": "object"
},
"shelf": {
"description": "The app store shelf the app sits on, one id: search, analytics, social, ads, commerce, financial_markets, banking_accounting, crm, productivity, developer, ai, public_data. Pick the one that matches what the app is about (a dashboard of Instagram posts is social, an order report is commerce). Optional while the app is private; apps action \"publish\" refuses with shelf_required until it has one. Any other value is refused with bad_shelf and the allowed ids.",
"type": "string"
},
"source_url": {
"description": "create: Optional link to the app's open source repository. update_manifest: Link to the open source repository.",
"type": "string"
},
"spec": {
"description": "The saved view/configuration as JSON (e.g. a Plotly spec, a filter set).",
"type": "object"
},
"tagline": {
"description": "create: One line saying what the app does, max 200 chars. Worth writing: it is what a user reads in the app store, and an app cannot be indexed without one. update_manifest: One-line description, max 200 chars.",
"type": "string"
},
"tier": {
"description": "Runtime model. 2 = sandboxed custom app (the default for anything you build here). Only set this if you know you need 1.",
"enum": [
1,
2
],
"type": "integer"
},
"title": {
"description": "Human title shown in the app and in my_workspace action \"app_artifact\".",
"type": "string"
},
"type": {
"description": "Your own label for the kind of artifact, e.g. \"chart\", \"report\", \"board\". Required when creating.",
"type": "string"
},
"version": {
"description": "upload_bundle: Optional version label this bundle belongs to. update_manifest: Free-text version, e.g. \"1.2.0\". Bundles are stored per version.",
"type": "string"
},
"visibility": {
"description": "write_artifact: Who may read the artifact. Default private. publish: \"public\" = listed in the app store. \"unlisted\" = link only. Default \"public\".",
"enum": [
"private",
"unlisted",
"public"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "apps",
"outputSchema": null
},
{
"description": "The builder spec reference for autario charts: chart types, required and optional fields per type, palettes, axis and annotation shapes, with examples. Charts render with Plotly.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "chart_instructions",
"outputSchema": null
},
{
"description": "Create, publish and update interactive Plotly charts on autario.com from autario data, each with its insight text and cited sources.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. create_from_spec = a chart from a builder spec, needs builder_spec, dataset_ids; publish = a chart from a Plotly spec, needs title, dataset_ids; update = replace spec, title or text of your chart, needs chart_id, plotly_spec.",
"enum": [
"create_from_spec",
"publish",
"update"
],
"type": "string"
},
"builder_spec": {
"description": "Structured Builder spec. Required: chart_type + x_col + y_col/y_cols (axis charts), label_col + value_col (pie/donut), x_col + group_by + value_col (heatmap). Optional: group_by, group_values, facet_by/facet_values (donut grid), heatmap_scale, title, palette/color_scheme, axis (x_title, y_title, y_min, y_max, log_scale, y_format, tick_angle, x_date_format), annotations, event_bands, overlays, legend_pos, bg_color, font_color, chart_height. See chart_instructions() for full reference.",
"type": "object"
},
"chart_id": {
"description": "The chart ID or slug returned by charts action \"publish\"",
"type": "string"
},
"dataset_ids": {
"description": "create_from_spec: UUID array of datasets backing this chart. Autario pulls real data from these tables. publish: Array of dataset UUIDs that this chart uses. Autario pulls real data from these datasets to ensure no hallucinated values",
"items": {
"type": "string"
},
"type": "array"
},
"insight": {
"description": "create_from_spec: 2-3 sentence data insight using ONLY numbers from get_data action \"query\"/find_data action \"schema\" results. Hallucinated numbers are rejected with the available anchor list. publish: 2-3 sentence data insight with specific numbers from the queried data. Must use verified numbers from get_data action \"query\" results, never from training data update: Updated insight text with verified numbers",
"type": "string"
},
"narration": {
"description": "create_from_spec: Longer description (optional, defaults to insight) publish: Longer description of the analysis methodology and context update: Updated analysis description",
"type": "string"
},
"plotly_spec": {
"description": "publish: Plotly specification with traces array and layout object. Traces use x_col/y_col for column references and group_by/group_value for filtering (e.g. {\"traces\": [{\"x_col\": \"year\", \"y_col\": \"value\", \"group_by\": \"country\", \"group_value\": \"USA\"}], \"layout\": {}}) update: Updated Plotly specification with traces and layout",
"type": "object"
},
"title": {
"description": "create_from_spec: Chart title (also settable via builder_spec.title; this top-level wins if both set). Format: \"{Topic} | {Scope} ({YYYY-YYYY}, {unit})\". The YYYY-YYYY year range is REQUIRED whenever the chart has a time axis (pull from the actual data span you queried). The unit is REQUIRED whenever find_data action \"info\" → unit is a non-empty string (copy verbatim, e.g. \"Mt CO2e\", \"% of GDP\", \"per 1,000 live births\"). If find_data action \"info\" → unit is null/empty, omit the unit | NEVER invent one. Example with both: \"Greenhouse Gas Emissions by Country (2010-2024, Mt CO2e) | World Bank\". Example unit-only: \"Infant Mortality by Race (per 1,000 live births) | NCHS\". publish: Chart title. Include time range in parentheses, use pipe | as separator (e.g. \"GDP Growth | Major Economies (2000-2024)\") update: Updated chart title",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "charts",
"outputSchema": null
},
{
"description": "Remove something the caller owns on autario: a dataset, all rows of a dataset, an app, or an accepted data edit. Cannot be undone.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. dataset = delete your dataset, needs dataset_id; rows = delete every row of your dataset, needs dataset_id; app = delete your app and its data, needs app_id, confirm; overlay = remove one accepted edit, needs dataset_id, id.",
"enum": [
"dataset",
"rows",
"app",
"overlay"
],
"type": "string"
},
"app_id": {
"description": "Id of an app you own, as returned by apps action \"create\". An app you do not own answers not found.",
"type": "string"
},
"confirm": {
"description": "Must be true. A call without it deletes nothing.",
"type": "boolean"
},
"dataset_id": {
"description": "dataset: The UUID of the dataset to permanently delete rows: The UUID of the dataset to clear all rows from overlay: The UUID of the dataset",
"type": "string"
},
"id": {
"description": "The overlay entry id",
"type": "number"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "delete",
"outputSchema": null
},
{
"description": "Search the autario catalogue of public statistics (World Bank, FRED, Eurostat, OECD, IMF, WHO, ECB, US Census, SEC) and your own connected datasets, and read a dataset's metadata and columns.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. search = keyword search over datasets; discover = datasets ranked for a topic by relevance, recency and source quality, needs topic; indicators = verified indicators that join across datasets; info = one dataset's source, coverage, freshness and change log, needs dataset_id; schema = one dataset's columns with their meaning, needs dataset_id.",
"enum": [
"search",
"discover",
"indicators",
"info",
"schema"
],
"type": "string"
},
"category": {
"description": "Filter by category. Options: \"Finance & Economics\", \"Trade\", \"Technology\", \"Health & Society\", \"Energy\", \"Environment\", \"Demographics\", \"Education\", \"Infrastructure\"",
"type": "string"
},
"dataset_id": {
"description": "info: The UUID of the dataset to retrieve metadata for schema: The UUID of the dataset to get the schema for",
"type": "string"
},
"depth_pref": {
"default": "any",
"description": "Preferred dataset shape. \"timeseries\" for trend articles (daily/weekly/monthly/quarterly/yearly cadence), \"cross-sectional\" for snapshots (rankings, lists), \"any\" for no preference.",
"enum": [
"timeseries",
"cross-sectional",
"any"
],
"type": "string"
},
"entity_type": {
"description": "Filter by entity_type: country | subnational | aggregate | company | security",
"type": "string"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"frequency": {
"description": "Filter by frequency: year | quarter | month | week | day",
"type": "string"
},
"limit": {
"description": "search: Maximum number of results to return (default 20, max 100) discover: Max datasets to return (1-50, default 10). indicators: Max results (default 50, max 500)",
"type": "number"
},
"page": {
"default": 1,
"description": "Page number for pagination (default 1)",
"type": "number"
},
"publisher": {
"description": "Filter by publisher (World Bank, Eurostat, FRED, WHO, …)",
"type": "string"
},
"query": {
"description": "Search term to match against dataset titles, descriptions, and keywords (e.g. \"GDP growth\", \"CO2 emissions\", \"unemployment rate\")",
"type": "string"
},
"recency_window": {
"default": "any",
"description": "Filter by data freshness. Default \"any\" returns all datasets regardless of last_refreshed_at; tighter windows for time-sensitive articles.",
"enum": [
"last_year",
"last_3_years",
"last_5_years",
"any"
],
"type": "string"
},
"search": {
"description": "Full-text search across indicator titles + descriptions",
"type": "string"
},
"topic": {
"description": "discover: The topic to find datasets for. Free-form, matches against asset topic field, title, keywords, category, and enriched description. Examples: \"AI investment\", \"EU energy transition\", \"global inflation\", \"tech platform shifts\" indicators: Filter by topic: economy | finance | trade | marketing | health | demographics | education | energy | environment | food | technology | media | housing | transport | tourism | space | government | military | minerals",
"type": "string"
},
"unit": {
"description": "Filter by unit: USD | EUR | % | per capita | per 1000 | years | tonnes | tonnes CO2 | GWh | TWh | index | count | …",
"type": "string"
},
"visibility": {
"description": "Which datasets to search: \"public\" catalog only, \"private\" only your own datasets, \"both\". Default: \"both\" when authenticated, \"public\" otherwise. Other users' private datasets are never returned.",
"enum": [
"public",
"private",
"both"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "find_data",
"outputSchema": null
},
{
"description": "Read the numbers: rows of one dataset with filters and aggregates, or indicator values for countries and companies joined across sources (World Bank, FRED, Eurostat, OECD, IMF, SEC).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. query = rows of one dataset, filtered, sorted, grouped or summarized, needs dataset_id; entity_data = several indicators for one country or company over time, needs entity_id, indicators; compare = one indicator across several countries or companies, needs entities, indicator; profile = every indicator autario holds for one country or company, needs entity_id.",
"enum": [
"query",
"entity_data",
"compare",
"profile"
],
"type": "string"
},
"aggregate": {
"description": "Comma-separated aggregations as \"func(column)\". Functions: avg, sum, count, min, max, stddev, median. Example: \"avg(value),count(*),max(price)\". Result columns are aliased as func_col (e.g. avg_value). Numerically correct on text-stored values.",
"type": "string"
},
"dataset_id": {
"description": "The UUID of the dataset to query",
"type": "string"
},
"entities": {
"description": "Entity codes to compare (max 50). E.g. [\"DEU\",\"USA\",\"CHN\"]",
"items": {
"type": "string"
},
"type": "array"
},
"entity_id": {
"description": "entity_data: Entity code (e.g. \"DEU\", \"USA\", \"EUU\") profile: Entity code (e.g. \"DEU\" for Germany, \"USA\" for United States, \"EUU\" for European Union, \"WLD\" for World)",
"type": "string"
},
"fields": {
"description": "Comma-separated list of columns to return (e.g. \"country_code,year,value\")",
"type": "string"
},
"filter": {
"description": "Filter conditions as \"column:operator:value\". Operators: eq, neq, gt, lt, gte, lte, like. Example: [\"country_code:eq:USA\", \"year:gte:2000\"]",
"items": {
"type": "string"
},
"type": "array"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"full": {
"description": "Return the full raw time series (heavy, many tokens). Default false → you get only the summary/stats, which is enough to ANSWER a question. Set true only when you must plot or export every point.",
"type": "boolean"
},
"groupby": {
"description": "Comma-separated columns for GROUP BY (only valid with aggregate). Example: \"country,year\". Use with aggregate to compute per-group statistics.",
"type": "string"
},
"indicator": {
"description": "Indicator ID to compare. Get from find_data action \"indicators\".",
"type": "string"
},
"indicators": {
"description": "Indicator IDs (max 10). Get these from find_data action \"indicators\" or get_data action \"profile\".",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"description": "query: Maximum number of rows to return (default 100, max 10000) profile: Max indicators to return (default 100, max 500)",
"type": "number"
},
"non_null_only": {
"default": false,
"description": "Drop rows whose value is null or storage junk (datasets are often mostly empty). Use to avoid wasting tokens on null rows. Default false.",
"type": "boolean"
},
"offset": {
"description": "query: Number of rows to skip for pagination (default 0) profile: Pagination offset (default 0). When has_more is true, pass offset = previous offset + returned for the next page.",
"type": "number"
},
"overlay": {
"description": "Which data: \"source\" (default) = exactly what the provider delivered; \"with_overlay\" = accepted derived columns, corrections and mappings merged in, each row with `_row_key` (use it in propose_*) and `_overlay` (original value, reason, who, when); \"proposed\" (owner only) = also the open proposals, each with its state. Not combinable with aggregate or summary_only.",
"enum": [
"source",
"with_overlay",
"proposed"
],
"type": "string"
},
"sort": {
"description": "Sort column and direction (e.g. \"year:desc\", \"value:asc\"). Aggregate aliases work too (e.g. \"sum_value:desc\")",
"type": "string"
},
"summary_only": {
"default": false,
"description": "Return only a finished per-column stats block (n, min, max, avg) plus first/last endpoint values, and NO raw rows. Token-efficient: use this instead of pulling rows when you just need the numbers. Default false.",
"type": "boolean"
},
"time": {
"description": "entity_data: Optional time range, e.g. \"2010-2023\" or \"2020\". Format: YYYY or YYYY-YYYY compare: Optional time range: \"2010-2023\" or \"2020\"",
"type": "string"
},
"topic": {
"description": "Optional: filter indicators by topic",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "get_data",
"outputSchema": null
},
{
"description": "Public company and market data from SEC filings and live quotes (Yahoo): company snapshots and fundamentals, stock screens, investor portfolios from Form 13F, and US House member trades.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. snapshot = current quote and key metrics of one company, needs ticker; fundamentals = SEC fundamentals of one company over time, needs ticker; screen = daily stock screens by growth, value, range or moving average; investors = the investors whose Form 13F autario reads; investor_portfolio = one investor's holdings and moves for a quarter, needs investor; who_holds = which tracked investors hold a company, needs ticker; politicians = US House members with reported trades; politician_trades = one member's reported stock trades, needs politician; congress_trades = US House trades in one stock, needs ticker.",
"enum": [
"snapshot",
"fundamentals",
"screen",
"investors",
"investor_portfolio",
"who_holds",
"politicians",
"politician_trades",
"congress_trades"
],
"type": "string"
},
"as_of": {
"description": "YYYY-MM-DD: the newest daily snapshot on or before this day (for backtests). Default: the newest.",
"type": "string"
},
"filters": {
"description": "Column ranges, e.g. {\"net_margin\":{\"min\":10},\"pct_vs_200w_ma\":{\"max\":-20}}. A row without the column is excluded.",
"type": "object"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"interval": {
"description": "Row spacing: the value known on the last trading day of each period. Default quarterly (token-efficient); daily for a backtest.",
"enum": [
"daily",
"monthly",
"quarterly"
],
"type": "string"
},
"investor": {
"description": "Investor slug from markets action \"investors\" (e.g. berkshire-hathaway, scion-asset-management), its display name, or its SEC CIK.",
"type": "string"
},
"limit": {
"description": "screen: Rows to return (default 25, max 200) investor_portfolio: Max holdings returned, largest first (default 500, max 5000). politician_trades, congress_trades: Max trades returned, newest first (default 200, max 2000).",
"type": [
"number",
"integer"
]
},
"metrics": {
"description": "snapshot: Metrics to return: price metrics (price, open, high, low, volume, perf_1d, perf_1w, perf_1m, perf_3m, perf_1y, perf_ytd, latest_date) and/or fundamental metric keys (e.g. revenue, roe, price-to-book, dividend-yield, revenue-growth-5y) or fundamentals for every fundamental row. If omitted, returns price + perf_1d + perf_ytd. fundamentals: Fields to return (see the list above). Default: close, adj_close, revenue, net_income, eps_diluted.",
"items": {
"type": "string"
},
"type": "array"
},
"order": {
"description": "asc | desc (default: best first)",
"type": "string"
},
"politician": {
"description": "Slug from markets action \"politicians\" (josh-gottheimer-nj) or a full or last name that matches exactly one member.",
"type": "string"
},
"preset": {
"description": "growth | profitability | value | near-52-week-high | near-52-week-low | below-200-week-ma | most-held-by-13f",
"type": "string"
},
"quarter": {
"description": "Quarter end date (2026-06-30) or label (2026-Q2). Omit for the latest reported quarter.",
"type": "string"
},
"sort": {
"description": "Column to order by (default: the rank column of the preset)",
"type": "string"
},
"ticker": {
"description": "snapshot: Stock ticker symbol, e.g. AAPL, MSFT, INTC, NVDA, SAP, BMW fundamentals: Stock ticker, e.g. AAPL, MSFT, KO who_holds: Stock ticker, e.g. AAPL, KO, GOOGL congress_trades: Stock ticker, e.g. NVDA, AAPL, MSFT",
"type": "string"
},
"window": {
"description": "fundamentals: Time window: 1y, 3y, 5y, 10y, max, or from:to as YYYY-MM-DD:YYYY-MM-DD (either side may be empty). Default 5y. politician_trades: 30d | 90d | 1y | 2y | all (default 1y), by transaction date. congress_trades: 30d | 90d | 1y | 2y | all (default 1y).",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "markets",
"outputSchema": null
},
{
"description": "What is on the caller's autario account and in the app store: apps, connectors (Google Ads, Meta Ads, Shopify, GA4 and more) with their health, charts, saved app views, and data edits waiting for review.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. overview = every app, connector and dataset on your account (sign-in); connectors = your connected platforms (sign-in); connector_status = freshness and report health of one connector (sign-in), needs connector_id; apps = apps in the autario app store; app_context = one app's data map and KPI catalogue, needs app_id; app_artifact = one saved app view, needs app_id, slug; app_preview_url = preview link of your own app (sign-in), needs app_id; charts = published charts; chart = one chart with its data and insight, needs chart_id; overlays = accepted edits on one of your datasets (sign-in), needs dataset_id; proposals = edits waiting for your review (sign-in), needs dataset_id.",
"enum": [
"overview",
"connectors",
"connector_status",
"apps",
"app_context",
"app_artifact",
"app_preview_url",
"charts",
"chart",
"overlays",
"proposals"
],
"type": "string"
},
"app_id": {
"description": "app_context: App id from my_workspace action \"apps\", e.g. \"audience-360\", \"company-compare\", \"projects\", \"builder\". app_artifact: App id from my_workspace action \"apps\", e.g. \"audience-360\", \"projects\", \"builder\". app_preview_url: Id of an app you own, as returned by apps action \"create\". An app you do not own answers not found.",
"type": "string"
},
"chart_id": {
"description": "The chart ID (numeric) or slug (hash like \"nMGf-iAO\") to retrieve",
"type": "string"
},
"connector_id": {
"description": "The id of the connector instance (from my_workspace action \"connectors\").",
"type": "string"
},
"dataset_id": {
"description": "The UUID of the dataset",
"type": "string"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
},
"kind": {
"description": "Only this kind",
"enum": [
"column",
"flag",
"correction",
"mapping"
],
"type": "string"
},
"limit": {
"description": "charts: Maximum number of charts to return (default 20, max 100) overlays, proposals: Max entries (default 500)",
"type": "number"
},
"offset": {
"default": 0,
"description": "Number of charts to skip for pagination",
"type": "number"
},
"q": {
"description": "Search term to filter charts by title or question",
"type": "string"
},
"slug": {
"description": "Artifact slug from my_workspace action \"app_context\" / my_workspace action \"overview\" (your_artifacts[].slug).",
"type": "string"
},
"state": {
"description": "Default accepted",
"enum": [
"accepted",
"proposed",
"rejected",
"superseded",
"all"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "my_workspace",
"outputSchema": null
},
{
"description": "Propose labels, flags, corrections and mappings on rows of the caller's datasets (Shopify orders, Google Ads campaigns, uploads) without touching the source, and accept or reject them.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. propose_column = a new label column, needs dataset_id, column, values; propose_flags = flag rows, needs dataset_id, rows; propose_corrections = corrected values for cells, needs dataset_id, corrections; propose_mappings = map raw values to clean ones, needs dataset_id, column, mappings; accept = accept proposals into the overlay, needs dataset_id, ids; reject = reject proposals, needs dataset_id, ids.",
"enum": [
"propose_column",
"propose_flags",
"propose_corrections",
"propose_mappings",
"accept",
"reject"
],
"type": "string"
},
"column": {
"description": "propose_column: New column name: lower case letters, digits and _, not an existing source column (e.g. \"topic\") propose_mappings: The source column whose values are mapped",
"type": "string"
},
"corrections": {
"description": "One entry per cell: {row_key, column, value, reason}",
"items": {
"properties": {
"column": {
"description": "The source column of the cell",
"type": "string"
},
"reason": {
"description": "Why, in one sentence (where the right value comes from, what looks wrong)",
"type": "string"
},
"row_key": {
"description": "The _row_key of the row, from get_data action \"query\" with overlay=\"with_overlay\"",
"type": "string"
},
"value": {
"description": "The new value for this row or cell",
"type": [
"string",
"number",
"boolean",
"null"
]
}
},
"required": [
"row_key",
"column",
"value"
],
"type": "object"
},
"type": "array"
},
"dataset_id": {
"description": "The UUID of the dataset",
"type": "string"
},
"ids": {
"description": "accept: Proposal ids from a propose_* answer or my_workspace action \"proposals\" reject: Proposal ids",
"items": {
"type": "number"
},
"type": "array"
},
"mappings": {
"description": "One entry per source value: {source_value, value (the canonical value), reason}",
"items": {
"properties": {
"reason": {
"description": "Why, in one sentence (where the right value comes from, what looks wrong)",
"type": "string"
},
"source_value": {
"description": "The value exactly as the source holds it",
"type": "string"
},
"value": {
"description": "The canonical value it means",
"type": [
"string",
"number",
"boolean"
]
}
},
"required": [
"source_value",
"value"
],
"type": "object"
},
"type": "array"
},
"reason": {
"description": "Why, applied to every entry without its own reason",
"type": "string"
},
"rows": {
"description": "One entry per flagged row: {row_key, column? (a single cell), reason}",
"items": {
"properties": {
"column": {
"description": "Only this cell (a source column); omit to flag the whole row",
"type": "string"
},
"reason": {
"description": "Why, in one sentence (where the right value comes from, what looks wrong)",
"type": "string"
},
"row_key": {
"description": "The _row_key of the row, from get_data action \"query\" with overlay=\"with_overlay\"",
"type": "string"
}
},
"required": [
"row_key"
],
"type": "object"
},
"type": "array"
},
"values": {
"description": "One entry per row: {row_key, value, reason?}",
"items": {
"properties": {
"reason": {
"description": "Why, in one sentence (where the right value comes from, what looks wrong)",
"type": "string"
},
"row_key": {
"description": "The _row_key of the row, from get_data action \"query\" with overlay=\"with_overlay\"",
"type": "string"
},
"value": {
"description": "The new value for this row or cell",
"type": [
"string",
"number",
"boolean",
"null"
]
}
},
"required": [
"row_key",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "proposals",
"outputSchema": null
},
{
"description": "Fetch the latest data from one of the caller's connected platforms (Google Search Console, Shopify, Meta Ads, Google Ads, GA4 and more) now and report per report what arrived. It never changes settings or the login, and runs at most once per connector per 10 minutes.",
"inputSchema": {
"properties": {
"connector_id": {
"description": "The id of the connector instance to refresh (from my_workspace action \"connectors\").",
"type": "string"
}
},
"required": [
"connector_id"
],
"type": "object"
},
"name": "refresh_connector",
"outputSchema": null
},
{
"description": "Report a data-quality problem in an autario dataset or chart (World Bank, FRED, Eurostat, OECD, WHO, IMF, SEC or another publisher) with the observed numbers as evidence. A repeat of an open report is counted on the existing finding, never duplicated.",
"inputSchema": {
"properties": {
"dataset_id": {
"description": "The UUID of the dataset the issue is about (from find_data action \"search\" / find_data action \"info\"). Omit only for a chart-level issue with no single owning dataset.",
"type": "string"
},
"detail": {
"description": "One-sentence human-readable summary of the issue.",
"type": "string"
},
"evidence": {
"description": "The concrete numbers backing the finding, as a JSON object. Examples: {\"rows_seen\": 500, \"rows_expected\": 15000, \"source\": \"World Bank API has ~15k country-year rows\"} or {\"unit\": \"%\", \"value_range\": [120, 9800]}. Required for an actionable finding.",
"type": "object"
},
"finding_type": {
"description": "What kind of problem. partial_ingest_suspected = fewer rows than the source has (truncated). stale = data older than it should be. broken_time_col = every row shares one date / a vintage column is used as time. unit_mismatch = declared unit contradicts the numbers. label = wrong/nonsensical column or series names. wrong_series = the wrong or a duplicate series is shown. confusing_chart = a published chart is misleading to end users. zero_variance = all values identical. engine_gap = a systematic parser/engine bug. moved/dead_source = source URL changed or returns 404.",
"enum": [
"partial_ingest_suspected",
"stale",
"broken_time_col",
"moved",
"dead_source",
"label",
"unit_mismatch",
"wrong_series",
"confusing_chart",
"zero_variance",
"engine_gap"
],
"type": "string"
},
"severity": {
"default": "medium",
"description": "How bad it is for end users. high = wrong/misleading numbers shown publicly. Default medium.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"required": [
"finding_type"
],
"type": "object"
},
"name": "report_data_issue",
"outputSchema": null
},
{
"description": "Publish the caller's own approved social drafts on the caller's own connected X account or LinkedIn company page through the official APIs: list the channels, list the drafts, approve one draft, or post every approved draft now. A draft is never posted without approval.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "targets = the channels this account can post to; drafts = the social_drafts rows; approve = set one draft to approved (needs draft_id); run = publish every approved draft now, one per channel.",
"enum": [
"targets",
"drafts",
"approve",
"run"
],
"type": "string"
},
"draft_id": {
"description": "approve only: the row id (dd_id) from drafts.",
"type": "string"
},
"format": {
"description": "Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless.",
"enum": [
"toon",
"compact",
"json"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "social_publish",
"outputSchema": null
},
{
"description": "Create your own dataset on autario and append rows to it, private by default, readable through the same tools as World Bank or FRED data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Which operation to run. create_dataset = a new empty dataset, needs title; write_rows = append rows to your dataset, needs dataset_id, rows.",
"enum": [
"create_dataset",
"write_rows"
],
"type": "string"
},
"category": {
"description": "Category for the dataset (e.g. \"Finance & Economics\", \"Health & Society\", \"Environment\")",
"type": "string"
},
"dataset_id": {
"description": "The UUID of the dataset to append rows to",
"type": "string"
},
"description": {
"description": "Description of the dataset contents, source, and methodology",
"type": "string"
},
"is_public": {
"default": false,
"description": "Whether the dataset is publicly visible (default false)",
"type": "boolean"
},
"rows": {
"description": "Array of row objects where keys are column names (e.g. [{\"country\": \"USA\", \"year\": \"2024\", \"value\": \"25000\"}])",
"items": {
"type": "object"
},
"type": "array"
},
"title": {
"description": "Dataset title (e.g. \"Global CO2 Emissions by Country\")",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "write_data",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:429034cf27fc19161416ed2730ae03beaba2d80095d3a1e43b9c4d664218aaf7 | sha256sum