---
title: "Tools - Chat Thing Documentation"
canonical_url: "https://chatthing.ai/docs/mcp-tools"
last_updated: "2026-07-13T16:51:23.478Z"
meta:
  description: "An overview of the Chat Thing MCP tool surface - what your agent can read, create and configure once it is connected."
  "og:description": "An overview of the Chat Thing MCP tool surface - what your agent can read, create and configure once it is connected."
  "og:title": Tools
  "twitter:description": "An overview of the Chat Thing MCP tool surface - what your agent can read, create and configure once it is connected."
  "twitter:title": Tools
---

**MCP**

# Tools

Once connected, your agent has access to the same actions you can take in the Chat Thing dashboard, exposed as MCP tools. You do not need to memorise these - your agent discovers them automatically and picks the right one. This page is a map of what is available so you know what to ask for.

## Bots

Create and manage bots, including their model, prompt and retrieval settings.

- `list_bots`, `get_bot` - see your bots and their configuration.
- `create_bot`, `update_bot`, `delete_bot` - build and tune a bot.
- `list_models` - list the chat models a bot can run on.

## Data sources

Give a bot knowledge by pointing it at your content.

- `discover_pages` - crawl a sitemap or URL to preview which pages would be indexed (this commits nothing).
- `add_data_source` - add a WEB, RSS, YouTube or MANUAL source.
- `list_data_sources`, `get_data_source`, `list_data_source_rows`, `list_discovered_pages` - inspect what is indexed.
- `update_data_source`, `delete_data_source`, `sync_data_source` - keep sources current.

## Power-ups

Give bots real-world actions beyond answering questions.

- `list_power_up_types`, `get_power_up_schema` - discover what a power-up needs before configuring it.
- `create_power_up`, `update_power_up`, `delete_power_up`, `toggle_power_up_enabled` - attach and manage actions like "talk to a human" or calling your API.

## Channels and hooks

Put your bot live and wire it into your systems.

- `get_web_channel`, `get_web_channel_schema`, `update_web_channel` - configure the website widget.
- `list_hook_types`, `get_hook_schema`, `create_hook`, `update_hook`, `delete_hook`, `test_hook`, `toggle_hook_enabled` - set up webhooks that fire on events.

## Testing

Catch regressions before your customers do.

- `create_test_case`, `update_test_case`, `delete_test_case`, `list_test_cases` - define expected behaviour.
- `start_test_run`, `get_test_run`, `list_test_runs` - run evaluations and read the results.

## Chats

Talk to a bot and inspect conversations end to end.

- `start_chat`, `send_message` - hold a conversation with a bot to verify it behaves.
- `list_chats`, `get_messages` - read past conversations.

## Uploads and account

- `upload_image` - upload an image (for example a bot avatar).
- `list_teams`, `list_provider_connections` - see the teams you can act on and the model providers connected.

## The discovery pattern

Configuration surfaces - power-ups, the web channel and hooks - follow a consistent three-step shape that your agent uses automatically:

1. **List the types** ( `list_power_up_types`, `list_hook_types`) to see what is available.
2. **Get the schema** ( `get_power_up_schema`, `get_hook_schema`, `get_web_channel_schema`) to learn exactly which fields a type needs.
3. **Create or update** with a valid config.

If a write is rejected, the server returns per-field errors alongside the schema, so your agent can correct itself in one retry. You rarely need to think about this - it is why an agent can configure a power-up correctly without you spelling out every field.

## Next

Ready to put it together? The [build-a-bot guide](https://chatthing.ai/docs/mcp-build-a-bot) walks through creating a working support bot from a single prompt.