---
title: "Voice agent insights tools in the Speak AI MCP"
description: "Review and act on a voice agent's self-improvement surface: knowledge gaps, FAQ suggestions, instruction gaps, and its knowledge-base resources. All 16 Voice agent insights tools, with parameters and behaviour hints."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice agent insights tools in the Speak AI MCP

The Voice agent insights category groups 16 of the Speak AI MCP server's tools.
Review and act on a voice agent's self-improvement surface: knowledge gaps, FAQ
suggestions, instruction gaps, and its knowledge-base resources.

## Which Voice agent insights tools does the Speak AI MCP server have?

The Speak AI MCP server has 16 Voice agent insights tools. Each one has its own page
with a plain-language summary, its parameters, and its behaviour hints.

- [`list_voice_kb_gaps`](/mcp/tools/voice-agent-intelligence/list_voice_kb_gaps/):
  List a voice agent's pending knowledge-base gaps: questions callers asked that the
  agent answered with low confidence or an explicit "I don't know," surfaced
  automatically after calls.
- [`analyze_voice_kb_gaps`](/mcp/tools/voice-agent-intelligence/analyze_voice_kb_gaps/):
  Trigger knowledge-base gap analysis over a voice agent's recent calls.
- [`add_voice_kb_gap`](/mcp/tools/voice-agent-intelligence/add_voice_kb_gap/): Write
  a knowledge-base gap's answer into the voice agent's attached knowledge base as a
  new document, and mark the gap added.
- [`dismiss_voice_kb_gap`](/mcp/tools/voice-agent-intelligence/dismiss_voice_kb_gap/):
  Mark a voice agent's knowledge-base gap dismissed without writing anything to the
  knowledge base.
- [`list_voice_faq_suggestions`](/mcp/tools/voice-agent-intelligence/list_voice_faq_suggestions/):
  List a voice agent's pending FAQ suggestions: questions multiple callers asked in
  similar form, clustered and drafted into a reusable question/answer pair.
- [`generate_voice_faq_suggestions`](/mcp/tools/voice-agent-intelligence/generate_voice_faq_suggestions/):
  Trigger FAQ clustering over a voice agent's recent calls.
- [`add_voice_faq_suggestion`](/mcp/tools/voice-agent-intelligence/add_voice_faq_suggestion/):
  Write an FAQ suggestion's question/answer into the voice agent's attached
  knowledge base as a new document, and mark the suggestion added.
- [`update_voice_faq_suggestion`](/mcp/tools/voice-agent-intelligence/update_voice_faq_suggestion/):
  Edit a still-pending FAQ suggestion's question and/or answer before adding it.
- [`dismiss_voice_faq_suggestion`](/mcp/tools/voice-agent-intelligence/dismiss_voice_faq_suggestion/):
  Mark a voice agent's FAQ suggestion dismissed without writing anything to the
  knowledge base.
- [`list_voice_agent_resources`](/mcp/tools/voice-agent-intelligence/list_voice_agent_resources/):
  List the knowledge documents/links a voice agent searches during calls: separate
  from KB gaps and FAQ suggestions, which are the self-improvement layer that
  surfaces what an agent is missing, not the content itself.
- [`create_voice_agent_resource`](/mcp/tools/voice-agent-intelligence/create_voice_agent_resource/):
  Add one document/link to a voice agent's knowledge base.
- [`bulk_create_voice_agent_resources`](/mcp/tools/voice-agent-intelligence/bulk_create_voice_agent_resources/):
  Add up to 100 documents/links to a voice agent's knowledge base in one call.
- [`update_voice_agent_resource`](/mcp/tools/voice-agent-intelligence/update_voice_agent_resource/):
  Partially update a voice agent resource: send at least one field.
- [`delete_voice_agent_resource`](/mcp/tools/voice-agent-intelligence/delete_voice_agent_resource/):
  Soft-delete a voice agent resource: it stops appearing in lists and the agent
  stops searching it, but the document is not physically removed.
- [`analyze_voice_instruction_gaps`](/mcp/tools/voice-agent-intelligence/analyze_voice_instruction_gaps/):
  Advisory only: compares a voice agent's current instructions against
  anchors/original intent/recent call summaries you supply and suggests up to 3
  patches.
- [`apply_voice_instruction_gap`](/mcp/tools/voice-agent-intelligence/apply_voice_instruction_gap/):
  Insert a suggested instruction patch into a voice agent's instructions and persist
  the result.

## Related

- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool across every
  category.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/voice-agent-intelligence/index.mdx