GovTribe
MCP tools

Show chart MCP tool

Minimal: {"kind":"trend","rows":[{"month":"Jan","awards":3}],"labelKey":"month","series":[{"key":"awards"}]}. Render a read-only inline chart: `trend` renders 1–4 line series in supplied row order; `comparison` renders 1–4 grouped vertical bar series in supplied row order; `leaderboard` renders one horizontal bar series ranked descending. IDs and series labels default; titles, descriptions, colors, formatting and footnotes are optional. Descriptions appear once; omit them when no context is needed. Hover or focus a mark for its full label and value. Currency requires an explicit currency code; percent requires an explicit fraction/unit basis.

Examples

Use charts when the user needs a compact visual for trends, comparisons, or ranked leaders. Use Show_Stats_Display for KPI cards instead.

  • trend: 1–4 line series, preserving supplied row order.
  • comparison: 1–4 grouped vertical bar series, preserving supplied row order.
  • leaderboard: exactly one horizontal bar series, sorted descending before applying maxItems.

An optional description appears once inside the loaded chart. Context remains available while loading or if the chart fails. Omit the description when the title and data provide enough context; no placeholder subtitle is added. Hover or focus a point or bar to read the full label and non-compact formatted value. Tooltips wrap long text and stay within the app frame's safe area; oversized content can be scrolled.

Use Tab and Shift+Tab to move between chart marks. When a focused mark has an oversized tooltip, Tab enters its scrollable content. From there, Shift+Tab returns to that mark and Tab advances to the next mark, or leaves the chart after the last mark. Escape dismisses the tooltip and returns focus to its mark.

Minimal working example

{
  "tool": "Show_Chart",
  "arguments": {
    "kind": "trend",
    "rows": [
      {
        "month": "Jan",
        "awards": 3
      }
    ],
    "labelKey": "month",
    "series": [
      {
        "key": "awards"
      }
    ]
  }
}

The presentation id is generated when omitted or null. Each series needs only key; its label defaults to the key with words separated (awardCount becomes Award Count). Titles, descriptions, footnotes, series colors and formatting overrides are optional. leaderboard defaults to 10 items, including when maxItems is null.

For numeric values, omitted or null formatting uses plain numbers. For currency, explicitly set kind: "currency" and a currency code such as currency: "USD". For percentages, explicitly set kind: "percent" and basis: "fraction" for 0.37, or basis: "unit" for 37. Missing currency codes and percentage bases produce validation errors with a corrected example. Precision and compact notation remain optional.

Show monthly obligated dollars as a trend

{
  "tool": "Show_Chart",
  "arguments": {
    "id": "monthly-obligations-trend",
    "kind": "trend",
    "title": "Monthly obligated dollars",
    "description": "Recent award activity for the selected market.",
    "rows": [
      {
        "month": "2026-01",
        "monthLabel": "Jan",
        "obligations": 12500000
      },
      {
        "month": "2026-02",
        "monthLabel": "Feb",
        "obligations": 18200000
      },
      {
        "month": "2026-03",
        "monthLabel": "Mar",
        "obligations": 16400000
      }
    ],
    "labelKey": "monthLabel",
    "fullLabelKey": "month",
    "series": [
      {
        "key": "obligations",
        "label": "Obligations"
      }
    ],
    "valueFormat": {
      "kind": "currency",
      "currency": "USD",
      "compact": true
    },
    "footnote": "Source: GovTribe award search rollup."
  }
}

Show top awardees as a leaderboard

{
  "tool": "Show_Chart",
  "arguments": {
    "id": "top-awardees-leaderboard",
    "kind": "leaderboard",
    "title": "Top awardees by obligated dollars",
    "rows": [
      {
        "vendor": "Example Systems LLC",
        "obligations": 42000000
      },
      {
        "vendor": "Modernization Partners Inc.",
        "obligations": 27500000
      },
      {
        "vendor": "Secure Mission Group",
        "obligations": 18800000
      }
    ],
    "labelKey": "vendor",
    "series": [
      {
        "key": "obligations",
        "label": "Obligations"
      }
    ],
    "valueFormat": {
      "kind": "currency",
      "currency": "USD",
      "compact": true
    },
    "maxItems": 10
  }
}

Payload patterns

Rows can use caller-defined keys, but every row must include the configured labelKey and every series.key.

Compare pipeline value and likely value by stage

{
  "tool": "Show_Chart",
  "arguments": {
    "id": "pipeline-stage-comparison",
    "kind": "comparison",
    "title": "Pipeline by stage",
    "rows": [
      {
        "stage": "Qualify",
        "pipelineValue": 12500000,
        "likelyValue": 3500000
      },
      {
        "stage": "Pursue",
        "pipelineValue": 8700000,
        "likelyValue": 4200000
      }
    ],
    "labelKey": "stage",
    "series": [
      {
        "key": "pipelineValue",
        "label": "Pipeline value"
      },
      {
        "key": "likelyValue",
        "label": "Likely value"
      }
    ],
    "valueFormat": {
      "kind": "currency",
      "currency": "USD",
      "compact": true
    }
  }
}

Set favorite

Add or remove a GovTribe record from the current user favorites. Favorites are a lightweight, record-level shortlist for later review. Use a saved search for a reusable query, and a pursuit for active capture work.

Show document

Preview a GovTribe user file or government file read-only, with authorized download links. In GovTribe AI, use open_in_govtribe_ai and the document-editing workflow for editing or annotation review in the dedicated document pane.

On this page

ExamplesMinimal working exampleShow monthly obligated dollars as a trendShow top awardees as a leaderboardPayload patternsCompare pipeline value and likely value by stageRelated articles