Tools Reference

This guide documents all 78 tools available in the Chipp MCP Server, organized by category.

Quick Reference

Jump to a category or use this table to find tools quickly:

Help

Tools for finding information about the MCP server itself.

search_documentation

Search the MCP server documentation to find information about tools, authentication, setup, and best practices.

Scope: None (public - no authentication required)

Example:

"Search docs for how to authenticate"
"Search documentation for rate limits"
"Find docs about creating apps"

Apps

Core CRUD operations for managing Chipp applications.

list_apps

List all applications accessible to the authenticated user.

Scope: apps:read

Example:

"List all my Chipp apps"
"Show apps in workspace 42"

get_app

Get detailed information about a specific application.

Scope: apps:read

Example:

"Get details for app 123"
"Show me the configuration of my FAQ bot"

create_app

Create a new application in a workspace.

Scope: apps:write

Example:

"Create a customer support bot called HelpDesk in workspace 5"
"Make a new app named FAQ Bot with a helpful assistant prompt"

update_app

Update an existing application's properties.

Scope: apps:write

Example:

"Rename app 123 to 'Support Bot v2'"
"Update the system prompt for my FAQ app to be more friendly"

delete_app

Soft-delete an application.

Scope: apps:write

Example:

"Delete app 123"
"Remove the test app I created"

chat_with_app

Send a message to an application and get a response. Useful for testing.

Scope: apps:read

Example:

"Test my FAQ bot with the question 'What are your hours?'"
"Send 'hello' to app 123 to check if it's working"

Configuration

Manage application settings, system prompts, and branding.

get_system_prompt

Get the system prompt for an application.

Scope: apps:read

update_system_prompt

Update an application's system prompt.

Scope: apps:write

get_model

Get the AI model configuration for an application.

Scope: apps:read

update_model

Change the AI model for an application.

Scope: apps:write

get_settings

Get detailed settings including RAG configuration.

Scope: apps:read

update_settings

Update application settings including RAG options.

Scope: apps:write

update_branding

Update visual branding for the application.

Scope: apps:write

Knowledge Sources

Manage RAG (Retrieval-Augmented Generation) knowledge bases.

list_knowledge_sources

List all knowledge sources for an application.

Scope: knowledge:read

get_knowledge_source

Get details about a specific knowledge source.

Scope: knowledge:read

add_url_source

Add a URL as a knowledge source. Automatically detects YouTube, Instagram, TikTok, and regular web pages.

Scope: knowledge:write

Example:

"Add https://docs.example.com to my FAQ app with crawl depth 2"
"Add this YouTube video to my training bot's knowledge base"

add_document_source

Upload a document as a knowledge source.

Scope: knowledge:write

Supported formats: PDF, DOCX, TXT, MD, CSV, JSON, HTML, PPTX, XLSX, code files (JS, TS, PY, etc.)

delete_knowledge_source

Remove a knowledge source from an application.

Scope: knowledge:write

refresh_knowledge_source

Re-crawl or re-process a knowledge source to update its content.

Scope: knowledge:write

Analytics

Access usage data, conversations, and metrics.

get_app_analytics

Get summary analytics for an application.

Scope: analytics:read

Returns: Message count, conversation count, unique users, satisfaction scores.

search_conversations

Search conversations with filters.

Scope: analytics:read

Example:

"Find conversations about refunds in my support bot"
"Show recent conversations from the last week"

get_conversation

Get a specific conversation with all messages.

Scope: analytics:read

get_top_queries

Get the most common user queries.

Scope: analytics:read

search_messages

Search individual messages across conversations.

Scope: analytics:read

export_conversations

Export conversations to JSON format.

Scope: analytics:read

get_tag_analytics

Get analytics for message tagging.

Scope: analytics:read

get_model_usage

Get model usage breakdown by model type.

Scope: analytics:read

get_moderation_stats

Get content moderation statistics.

Scope: analytics:read

get_user_memories

Get extracted user memories for an application.

Scope: analytics:read

get_file_analytics

Get statistics about file uploads and usage.

Scope: analytics:read

get_popular_apps

Get most popular apps by usage.

Scope: analytics:read

Tags

Manage intent tags for message classification and automated responses.

list_tags

List all tags for an application.

Scope: apps:read

get_tag

Get details for a specific tag including utterances.

Scope: apps:read

create_tag

Create a new intent tag.

Scope: apps:write

Action types:

• staticText: Replace AI response with fixed text
• freeze: Stop conversation flow
• notification: Send webhook or email alert

Example:

"Create a tag called 'pricing' for my sales bot with utterances like 'how much does it cost'"

update_tag

Update an existing tag.

Scope: apps:write

delete_tag

Delete a tag.

Scope: apps:write

list_tag_instances

List messages that matched a specific tag.

Scope: analytics:read

remove_tag_instance

Remove a tag match from a message (false positive correction).

Scope: apps:write

generate_utterances

Use AI to generate training utterances for a tag.

Scope: apps:write

Example:

"Generate 100 utterances for detecting pricing questions in an e-commerce context"

Evaluations

Create and run quality tests for your applications.

list_evals

List all evaluations for an application.

Scope: apps:read

get_eval

Get details for a specific evaluation.

Scope: apps:read

create_eval

Create a new evaluation from a conversation.

Scope: apps:write

Test case format:

{
  "input": "What are your hours?",
  "expectedOutput": "We're open 9-5 Monday through Friday",
  "criteria": ["mentions hours", "includes days"]
}

update_eval

Update an existing evaluation.

Scope: apps:write

delete_eval

Delete an evaluation.

Scope: apps:write

run_eval

Execute an evaluation and get results.

Scope: apps:write

┌─────────────────────────────────────────┐
│           Evaluation Results            │
├─────────────────────────────────────────┤
│ Pass Rate: ████████░░ 80%               │
│ Avg Score: 0.85                         │
└─────────────────────────────────────────┘

list_eval_results

List past evaluation runs.

Scope: apps:read

get_eval_result

Get detailed results from a specific evaluation run.

Scope: apps:read

Custom Actions

Manage API integrations for your applications.

list_custom_actions

List all custom actions for an application.

Scope: actions:read

get_custom_action

Get details for a specific custom action.

Scope: actions:read

create_custom_action

Create a new API integration.

Scope: actions:write

update_custom_action

Update an existing custom action.

Scope: actions:write

delete_custom_action

Delete a custom action.

Scope: actions:write

MCP Integrations

Connect external MCP servers to your applications.

list_mcp_integrations

List all connected MCP servers for an application.

Scope: actions:read

get_mcp_integration

Get details about a connected MCP server.

Scope: actions:read

connect_mcp_server

Connect an external MCP server to an application.

Scope: actions:write

update_mcp_integration_tools

Enable or disable specific tools from a connected MCP server.

Scope: actions:write

disconnect_mcp_server

Remove an MCP server connection.

Scope: actions:write

Deployments

Manage multi-channel deployments (Slack, WhatsApp, Email, Voice).

list_slack_deployments

List Slack workspace connections.

Scope: apps:read

get_slack_deployment

Get details about a Slack deployment.

Scope: apps:read

disconnect_slack_deployment

Remove a Slack connection.

Scope: apps:write

get_whatsapp_deployment

Get WhatsApp business configuration.

Scope: apps:read

get_voice_config

Get voice agent configuration.

Scope: apps:read

update_voice_config

Update voice agent settings.

Scope: apps:write

get_email_deployment

Get email channel configuration.

Scope: apps:read

update_email_deployment

Update email channel settings.

Scope: apps:write

Workspaces

Manage workspaces, members, and billing information.

list_workspaces

List all workspaces you have access to.

Scope: workspace:read

get_workspace

Get details about a specific workspace.

Scope: workspace:read

list_workspace_members

List members of a workspace.

Scope: workspace:read

get_subscription

Get subscription details for an organization.

Scope: billing:read

get_credits

Get credit balance and usage.

Scope: billing:read

get_usage

Get detailed usage breakdown.

Scope: billing:read

Prompt Engineering

AI-assisted tools for improving prompts and selecting models.

improve_system_prompt

Use AI to improve an existing system prompt.

Scope: apps:write

generate_system_prompt

Generate a new system prompt from a description.

Scope: apps:write

list_suggestions

Get suggested improvements for an application.

Scope: apps:read

update_suggestions

Mark suggestions as applied or dismissed.

Scope: apps:write

generate_suggestions

Generate new improvement suggestions.

Scope: apps:write

list_available_models

List all AI models available for use.

Scope: apps:read

recommend_model

Get AI-powered model recommendations for your use case.

Scope: apps:read

Appendix

Permission Scopes

Common Error Codes

Next Steps

• Common Workflows - Step-by-step examples
• Rate Limits - Usage limits and best practices
• Authentication - Token management