> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/kaiya/tellius-mcp-server/what-tellius-can-do-through-mcp.md).

# What Tellius can do through MCP

Once your client is connected, these are the tools it can call. In addition to `tellius_ask` for questions, and the discovery tools to find the right Business View, there are additional tools to build workflows, schedule delivery, or manage saved memories.

Some tools create, change, or permanently delete workflows and schedules. The access column marks which.

#### **Discovery**

| Tool                                | Access    | What it does                                                              |
| ----------------------------------- | --------- | ------------------------------------------------------------------------- |
| `tellius_list_business_views`       | Read-only | Search and page through Business Views. The starting point for most work. |
| `tellius_get_business_view_details` | Read-only | Full column schema, data types, and sample values for one Business View.  |
| `tellius_list_datasets`             | Read-only | Raw imported datasets, before they are modeled into a Business View.      |
| `tellius_list_connections`          | Read-only | Configured data source connections.                                       |

#### **Ask and analyze**

| Tool                            | Access     | What it does                                                                     |
| ------------------------------- | ---------- | -------------------------------------------------------------------------------- |
| `tellius_ask`                   | Read/write | Natural-language question answered as SQL and results.                           |
| `tellius_deep_insight`          | Read/write | Multi-step agentic investigation for "why" questions.                            |
| `tellius_get_starter_questions` | Read-only  | Suggested questions for a Business View, for users who are not sure what to ask. |
| `tellius_send_feedback`         | Read/write | Record a thumbs up or down on a previous Kaiya response.                         |

#### **Workflows and Missions**

| Tool                       | Access      | What it does                                             |
| -------------------------- | ----------- | -------------------------------------------------------- |
| `tellius_list_workflows`   | Read-only   | Paginated list of workflows and Kaiya Missions.          |
| `tellius_search_workflows` | Read-only   | Search by name or description.                           |
| `tellius_get_workflow`     | Read-only   | Full step detail for one workflow or Mission.            |
| `tellius_create_workflow`  | Read/write  | Author a new reusable multi-step workflow.               |
| `tellius_update_workflow`  | Read/write  | Change the name, steps, state, or Business Views.        |
| `tellius_delete_workflow`  | Destructive | Permanent delete.                                        |
| `tellius_run_workflow`     | Read/write  | Execute headlessly. May pause for input before starting. |
| `tellius_resume_workflow`  | Read/write  | Continue a run that paused mid-execution.                |

#### **Schedules**

| Tool                      | Access      | What it does                                                  |
| ------------------------- | ----------- | ------------------------------------------------------------- |
| `tellius_create_schedule` | Read/write  | Recurring delivery of a saved workflow or an ad-hoc question. |
| `tellius_list_schedules`  | Read-only   | Schedules belonging to the calling user.                      |
| `tellius_get_schedule`    | Read-only   | Full delivery configuration for one schedule.                 |
| `tellius_update_schedule` | Read/write  | Pause, resume, or change cadence and delivery channels.       |
| `tellius_delete_schedule` | Destructive | Permanent delete.                                             |

#### **Channels, memory, and reference content**

| Tool                               | Access     | What it does                                                                          |
| ---------------------------------- | ---------- | ------------------------------------------------------------------------------------- |
| `tellius_list_slack_channels`      | Read-only  | Channel ids for Slack delivery on a schedule.                                         |
| `tellius_list_teams_channels`      | Read-only  | Channel and team ids for Teams delivery on a schedule.                                |
| `tellius_remember_user_preference` | Read/write | Save a memory (a rule, a definition, or an instruction) that later turns will recall. |
| `tellius_list_user_memories`       | Read-only  | Review saved memories.                                                                |

### **Resources**

Resources are addressable pieces of context a client can read directly, without calling a tool.

| Resource                                  | Contents                                    |
| ----------------------------------------- | ------------------------------------------- |
| `tellius://business-views`                | Live list of Business Views.                |
| `tellius://business-views/{id}/schema`    | Column schema for one Business View.        |
| `tellius://datasets/{id}/schema`          | Column schema for one dataset.              |
| `tellius://guides/tellius-capabilities`   | What Kaiya can and cannot do.               |
| `tellius://guides/business-view-modeling` | Joins, column types, and modeling guidance. |
| `tellius://guides/workflow-design`        | How to write effective workflow steps.      |

### **Prompts**

A prompt is a starting point your client can offer, rather than something you type. Where tools are single actions your client calls one at a time, a prompt is a prepared sequence. It sets out the steps for a longer task and walks the client through them in order.

This helps most when you know the outcome you want but not which tools get you there.

| Prompt                   | What it walks through                                                 |
| ------------------------ | --------------------------------------------------------------------- |
| `tellius_setup_data`     | Connection, then dataset, then Business View, then a first query.     |
| `tellius_analyze`        | Discover data, explore the schema, then analyze.                      |
| `tellius_build_workflow` | Clarify the goal, draft the steps, create the workflow, then test it. |

### **Quick reference**

| Item                  | Value                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------- |
| Protocol              | MCP over streamable HTTP                                                              |
| Endpoint              | A URL ending in `/mcp` — get the full address from your administrator                 |
| Setup                 | Point an MCP client at the URL and sign in. Nothing to install.                       |
| Main tool for metrics | `tellius_ask`                                                                         |
| Request               | `question` with filters in the text, plus `business_view_ids` and `include_raw: true` |
| Authentication        | Browser sign-in, once; token refreshed automatically                                  |
| Permissions           | Runs as a Tellius user; row-level security applies                                    |
| Read the value from   | The returned data table                                                               |
| Validate with         | The returned SQL, plus a rollup or range check                                        |
| Tools available       | 25 tools, 6 resources, 3 prompts                                                      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.tellius.com/kaiya/tellius-mcp-server/what-tellius-can-do-through-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.