--- name: "view_show" area: "views" title: "Show someone a page of results" price: "$0.01" method: "POST" url: "https://api.conecto.chat/v1/tools/view_show" mcp_server: "https://api.conecto.chat/mcp/views" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/views/view_show" --- # Show someone a page of results (`view_show`) Draws numbers, charts, bars, tables, lists and text on one page, with a link to it that opens once, for a person to look at. Draw numbers, charts, bars, tables, lists and text on one page and get a one-time link to it, to send to a person: the first browser that opens it keeps it for an hour, and an unopened link expires after 7 days. Conecto keeps no dashboards of its own; this is how a person sees what you found, from any area or anywhere else. blocks is a list, drawn top to bottom. Each block is one of: {"type": "heading", "text"}; {"type": "text", "text"} (blank lines make paragraphs); {"type": "metrics", "items": [{"label", "value", "format", "currency", "change" (percent), "better": "up"|"down", "note", "tone": "good"|"warn"|"bad"}]} (up to 8 numbers in a row); {"type": "chart", "title", "kind": "line"|"bar", "labels": [...], "series": [{"name", "values": [...]}], "format", "currency"} (up to 4 series of up to 400 points); {"type": "bars", "title", "label_header", "value_header", "items": [{"label", "value", "detail", "link", "country" (a two-letter code: shows the flag, and the name when label is left out)}], "format", "currency"} (ranked rows with a bar each, up to 50); {"type": "table", "title", "columns": [{"label", "format", "currency"}], "rows": [[...], ...]} (up to 12 columns and 500 rows); {"type": "list", "title", "items": [{"title", "text", "meta", "link"}]} (up to 100); {"type": "divider"}. format is number, percent (49 means 49%), currency (with currency, like "EUR"), seconds (a length of time), milliseconds or text. bars, table, list and metrics take "width": "half" to sit beside the next half block. Price: $0.01 a call. A call that fails costs nothing. ## Use it when A person should see results rather than read them: a report, a comparison, a list to check. - For a page kept under a name and updated over time, use [view_save](https://conecto.chat/tools/views/view_save.md). ## Say this to your agent > Show me last week's sales in a way I can look at on my phone. ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `title` | string | yes | 1 to 200 characters. | | | | `subtitle` | string | no | A line under the title, like the period it covers. Up to 300 characters. | | | | `blocks` | array of objects | yes | blocks is a list, drawn top to bottom. Each block is one of: {"type": "heading", "text"}; {"type": "text", "text"} (blank lines make paragraphs); {"type": "metrics", "items": [{"label", "value", "format", "currency", "change" (percent), "better": "up"\|"down", "note", "tone": "good"\|"warn"\|"bad"}]} (up to 8 numbers in a row); {"type": "chart", "title", "kind": "line"\|"bar", "labels": [...], "series": [{"name", "values": [...]}], "format", "currency"} (up to 4 series of up to 400 points); {"type": "bars", "title", "label_header", "value_header", "items": [{"label", "value", "detail", "link", "country" (a two-letter code: shows the flag, and the name when label is left out)}], "format", "currency"} (ranked rows with a bar each, up to 50); {"type": "table", "title", "columns": [{"label", "format", "currency"}], "rows": [[...], ...]} (up to 12 columns and 500 rows); {"type": "list", "title", "items": [{"title", "text", "meta", "link"}]} (up to 100); {"type": "divider"}. format is number, percent (49 means 49%), currency (with currency, like "EUR"), seconds (a length of time), milliseconds or text. bars, table, list and metrics take "width": "half" to sit beside the next half block. 1 to 60 items. | | | | `blocks[].type` | string | yes, in each item of `blocks` | | `"heading"`, `"text"`, `"metrics"`, `"chart"`, `"bars"`, `"table"`, `"list"`, `"divider"` | | ## Example Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. MCP: call `view_show` on the MCP server `https://api.conecto.chat/mcp/views` with these arguments: ```json { "title": "Halverson Cycle & Repair, last week", "subtitle": "October 5 to 11, 2026", "blocks": [ { "type": "metrics", "items": [ { "label": "Revenue", "value": 14620, "format": "currency", "currency": "USD", "change": 12.4 }, { "label": "Orders", "value": 41 }, { "label": "Average order", "value": 357, "format": "currency", "currency": "USD" } ] }, { "type": "chart", "title": "Orders a day", "kind": "bar", "labels": [ "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun" ], "series": [ { "name": "Orders", "values": [ 4, 5, 7, 6, 8, 11, 0 ] } ] }, { "type": "bars", "title": "Best sellers", "items": [ { "label": "Full tune-up", "value": 14 }, { "label": "Tabor gravel bike", "value": 5 }, { "label": "Willamette 8", "value": 4 } ] } ] } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/view_show \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"title": "Halverson Cycle & Repair, last week", "subtitle": "October 5 to 11, 2026", "blocks": [{"type": "metrics", "items": [{"label": "Revenue", "value": 14620, "format": "currency", "currency": "USD", "change": 12.4}, {"label": "Orders", "value": 41}, {"label": "Average order", "value": 357, "format": "currency", "currency": "USD"}]}, {"type": "chart", "title": "Orders a day", "kind": "bar", "labels": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"], "series": [{"name": "Orders", "values": [4, 5, 7, 6, 8, 11, 0]}]}, {"type": "bars", "title": "Best sellers", "items": [{"label": "Full tune-up", "value": 14}, {"label": "Tabor gravel bike", "value": 5}, {"label": "Willamette 8", "value": 4}]}]}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "view_show", "status": "succeeded", "replayed": false, "cost_usd": "$0.01", "balance_usd": "$19.75", "result": { "view": { "name": null, "title": "Halverson Cycle & Repair, last week", "subtitle": "October 5 to 11, 2026", "blocks": 3, "saved": false, "created_at": "2026-10-14T08:00:00+00:00", "updated_at": "2026-10-14T08:00:00+00:00" }, "link": "https://cncto.co/v/y24JuMFZbnHwR5d8UWP0R1QC", "opens": "once", "expires_at": "2026-10-21T08:00:00+00:00", "note": "The first browser that opens it keeps it for an hour; anyone else is told it was used. Make another link for someone else." } } ``` `result`: view: its title, subtitle and how many blocks; link: the one-time link, opens (once), expires_at, and a note on how it opens. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | A block is not in the form this page lists: an unknown type, a chart with a value count that does not match its labels, a table row with the wrong number of cells, or a page over about 300 KB. | Fix the block the message names. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [view_save](https://conecto.chat/tools/views/view_save.md): Keeps a page under a name, like the weekly dashboard, and replaces what it shows on each call. $0.01 a call. - [view_link](https://conecto.chat/tools/views/view_link.md): A one-time link to a saved page as it is now, for one person. Free. - [view_send_link](https://conecto.chat/tools/views/view_send_link.md): Emails each person, and posts to each channel, their own one-time link to a saved page as it is now. $0.02 per email, $0.005 per channel, up to $0.225. - [view_list](https://conecto.chat/tools/views/view_list.md): The saved pages, most recently changed first. Free up to 1,000,000 reads a month. - [view_get](https://conecto.chat/tools/views/view_get.md): A saved page with all its blocks, to change part of it. Free up to 1,000,000 reads a month. - [view_delete](https://conecto.chat/tools/views/view_delete.md): Deletes a saved page; its links stop working. Free.