Jepto

List saved analysis items for a view and period (read-only). Requires clientId, viewId, and startDate+endDate or qStartMs+qEndMs.

report_analysis_list

Generate written analysis for a report view: provisions the analysis card when needed, invokes the report-analysis agent, and by default waits for completion and returns saved analysis rows (set waitForCompletion false for fire-and-forget).

report_analysis_run

Save one analysis item (headline + markdown) for a view and date range. Use after analytics research or when revising narrative text.

report_analysis_save

Create a report card from JSON, saved exactly as sent (no model involved). chart/table: pass cardConfig {cardType, chartType (chart only), title, data, visualization?, presentation?, paletteId?}. data holds the query: metrics and/or dimensions with exact names from analytics_schema (a table may list dimensions only), timeDimension, filters, order, comparison. Optional ids on data fields (metric_<x> / dimension_<x>) are kept, so visualization can reference them. visualization = overrides deep-merged on Jepto defaults: chart options for charts; for tables pagination, sorting, rendering, columns [{id, width, header, cells}] and columnOrder [ids]. presentation.number = Number card format {prefix, suffix, precision, compact}, showSparkline, valueSize. Colors come from paletteId, not visualization. Rules: only keys you change; plain JSON, no functions; arrays replace on merge, so omit series rather than sending series: []; query fields stay in data. An invalid config returns error.details per field. Static cards: markdown/html (static copy, not KPI totals), image, analysis, filter (set controlType, e.g. date_range) via cardType + title/content/image. Examples: skills_get dataChatReport; help_article https://www.jepto.com/help/custom-visualizations. Cards are throwaway until placed: call report_page_get then report_page_update in the same flow (needsPlacement). To style a chart in plain language, create it first, then call report_card_update with visualizationPrompt.

report_card_create

Soft-delete a card by cardId (layout updates on the server). clientId is optional when the target id is provided; delete uses account scope and that id only.

report_card_delete

Generate a chart or table card from a text prompt (a model picks fields and chart). To create a card from a JSON config, including custom visualization, use report_card_create with cardConfig instead: it is faster, uses no model and returns field errors rather than reinterpreting the config. cardConfig here is deprecated. Do not combine a complete cardConfig with visualizationPrompt; create the card first and apply plain-language styling with report_card_update. cardType chart or table is kept as requested. Run analytics_query first so the field names and date range are known. Do not substitute a metric from another schema entity (for example googleBusinessProfile.reviewCount on a posts table); use the matching entity metric (postCount) or return a schema error. Cards are persisted unplaced: place them via report_page_get + report_page_update (needsPlacement). needsAttention when the data check finds no rows (fix with report_card_update, then place). Optional dateRange overrides the preflight analytics check (default: card → page → report range → last30days). Load skills_get skillId dataChatReport first. On failure, error includes type, message, retryable, and optional retryAfterSeconds (retry once for retryable errors).

report_card_generate

Load a card configuration for editing or placement.

report_card_get

Validate and persist card updates; requires clientId and cardId. Validates metric and dimension names against analytics_schema, enriches dataType/aggregation, and assigns unique metric IDs. Pass revisions from report_card_get; stale → CONFLICT (re-read and retry). Pass configDelta for data/title/pageId/paletteId, and for visualization (chart or table overrides) and presentation.number as raw JSON, same rules as report_card_create. visualizationPrompt describes styling in words instead and applies only to chart visualizations; Number cards must use configDelta.presentation.number. Styling updates merge onto the card's stored visualization and presentation, so send only what changes: earlier legend, tooltip or caption settings are kept. visualization.series entries merge by index or metric identity; ids take precedence over names/labels, which must identify one series. Unmatched identities or ambiguous names return VALIDATION. Other arrays replace. Use plotOptions.series only for all-series styling. Send legend.position or legend.verticalAlign (top/bottom); the other is synchronized. Conflicting vertical positions return VALIDATION. Set legend.align separately. Raw visualization and visualizationPrompt updates merge; prompt values win on overlap. Send visualization: null to clear visualization overrides, or presentation: null to clear presentation overrides; omit either key to preserve it. To move to another tab, remove the card from the old page layout before setting pageId.

report_card_update

Create report shells (view + page tabs). Jepto assigns viewId and pageIds. Pass every initial tab in pages[] in this one call; use report_page_create only to add tabs later. pages: [{title, description?, layout?, includeDateFilter?, dateRange?}] — optional per-tab dateRange only affects create-time filter-card defaults; set report dateRange on this tool or report_update. MCP adds a page title header and date-range filter cards on data tabs (includeDateFilter false for static-only). Then analytics preflight and report_card_generate / report_page_update per tab. Multi-page: name the first tab Executive Overview. skills_get skillId dataChatReport for the workflow.

report_create

Soft-delete a report by viewId. clientId is optional when the target id is provided; delete uses account scope and that id only.

report_delete

Load report structure, pages, layout slots, and cards for a view. Requires clientId and viewId. May include editorUrl, previewUrl, and publicUrl. Layout slots include cardId, cardType, chartType, and grid (x,y,w,h). cards[] includes cardId, title, cardType, and chartType — use report_card_get for full config. Use report_page_get for one tab's revisions and layout. Optional checklist: empty tabs, tabs without data cards, executive/summary tabs missing an analysis card.

report_get

List reports (views). Omit clientId for account scope; pass clientId for one client. Returns viewId, clientId, title, description, dateRange, page summaries (pageId, title, order only — not layout or cards), and optional editorUrl. Use limit/offset; totalItems when returned. Use report_get with that row's clientId and viewId for layout and cards.

report_list

Add one page tab to an existing report. Provisions a page title header and, when includeDateFilter is true or the tab will hold chart/table/analysis cards, a date-range filter card tied to the view dateRange (report_create / report_update). dateRange on this tool is ignored. includeDateFilter false for static-only tabs. Executive/Summary tabs: report_analysis_run, not markdown with hand-typed metrics.

report_page_create

Soft-delete a report page by pageId. clientId is optional when the target id is provided; delete uses account scope and that id only.

report_page_delete

Load a report page (title, description, layout, revisions).

report_page_get

Update page title, description, and/or layout. Layout is authoritative: send every slot on the page. Filter cards on the layout follow report dateRange (report_update); dateRange here alone is rejected — include layout/title/description changes. Requires revisions from report_page_get. Invalid/overlapping layout → LAYOUT_INVALID; stale revisions → CONFLICT (re-read report_page_get). Page title header: the html card whose content has data-jepto-chrome="page_header". Keep its cardId in the layout; you may resize or move it, e.g. title x=0,w=20 and the date-range filter x=20,w=4 on the same row. Restyle it (transparent background, border) with report_card_update style.colors.light.card / style.colors.dark.card, not inline CSS. Page writes never add a second header while it is in the layout. 24-column grid (x,y,w,h). To move a card: drop from source layout, report_card_update configDelta.pageId, full layout on target page.

report_page_update

Create an account palette (label plus light and dark hex color arrays).

report_palette_create

Delete a palette by paletteId. Use report_palette_get to confirm what you are deleting.

report_palette_delete

Load one palette by paletteId (label, light and dark colours). Palette updates and deletes do not need revisions.

report_palette_get

List account color palettes (for themes and per-card paletteId). Requires clientId.

report_palette_list

Update a palette patch (label, light, dark). Use report_palette_get to check current values first.

report_palette_update

Create a report theme (label, optional paletteId, optional themeInput). themeInput keys: colors, grid, typography, card, maxWidth, padding, paletteId, label. See the branding workflow resource for a full themeInput example; report_theme_get returns resolved settings.

report_theme_create

Delete a theme by themeId. Use report_theme_get to confirm what you are deleting.

report_theme_delete

Load one theme by themeId. Theme updates and deletes do not need revisions.

report_theme_get

List account report themes. Requires clientId; optional viewId filter.

report_theme_list

Update a theme (patch and/or themeInput). Use report_theme_get to check current values first.

report_theme_update

Update report metadata (title, description, dateRange, themeId). Pass revisions from report_get (external MCP). Stale revisions → error type CONFLICT with currentRevisions; re-read report_get and retry.

report_update

Returns one catalog skill by skillId: summary fields plus the full SKILL.md body in content (preferring the bundled catalog shipped with MCP when it is longer than the stored copy). Also returns contentUri (skill://…/SKILL.md MCP resource), contentSource, contentLength, and contentComplete.

skills_get

Lists skills in the Jepto catalog. Returns JSON with skills[] (skillId, name, description, agentScope, modes, version) and count. Metadata only; full markdown is returned by skills_get.

skills_list

Shows a Jepto report inline as an interactive MCP App: the same page tabs and live cards as the report's share link. Takes the viewId from create_report or get_report and an optional pageId to open first. Returns the share URL, share id, title and access. Private and hidden reports render for their owner using a report-scoped, one-hour viewer token. If viewer-token signing is not configured, they return the URL only.

view_report

Fetch and extract content from a public URL (not report-specific).

web_fetch

Search the public web for external context (not report-specific).

web_search