# MCP Tool Definition Not Found

**URL:** <https://community.retellai.com/t/mcp-tool-definition-not-found/184>\
**Category:** Support Help\
**Created:** [December 1, 2025, 4:40pm UTC](https://community.retellai.com/t/mcp-tool-definition-not-found/184 "2025-12-01T16:40:14Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![MedCalls\_AI](https://yyz2.discourse-cdn.com/flex008/user_avatar/community.retellai.com/medcalls_ai/32/163_2.png) [@MedCalls\_AI](https://community.retellai.com/u/MedCalls_AI)\
**Post date:** [December 1, 2025, 4:40pm UTC](https://community.retellai.com/t/mcp-tool-definition-not-found/184/1 "2025-12-01T16:40:14Z")

</div>

Anyone have any issues with MCP Tool Definition Not Found? It could not be more clearly set, but I keep getting this error, and wonder if anyone has any troubleshooting steps

---

<div class="post-metadata">

**Author:** ![support2](https://yyz2.discourse-cdn.com/flex008/user_avatar/community.retellai.com/support2/32/15_2.png) [@support2](https://community.retellai.com/u/support2)\
**Post date:** [December 1, 2025, 4:40pm UTC](https://community.retellai.com/t/mcp-tool-definition-not-found/184/2 "2025-12-01T16:40:39Z")

</div>

Based on the available sources, here are troubleshooting steps for MCP tool detection issues:

**Common Causes:**

The MCP server connectivity is typically the root cause[(1)](https://discord.com/channels/1186424376300679209/1419610738116264076). Check these areas:

1. **Verify MCP Server Status**

2. **Check Server Logs**

3. **Restart Connection**

**Configuration Steps:**

When setting up MCP in Retell AI[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp):

- Add MCP configuration with proper authentication[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp)
- Set request headers if needed[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp)
- Configure query parameters if required[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp)
- Select the MCP tool from available tools[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp)
- Update your prompt to explicitly state when to invoke the tool[(2)](https://docs.retellai.com/build/single-multi-prompt/mcp)

**API Verification:**

You can verify available tools using the Get MCP Tools endpoint[(3)](https://docs.retellai.com/api-references/get-mcp-tools):

```javascript
import Retell from 'retell-sdk';
const client = new Retell({
 apiKey: 'YOUR_RETELL_API_KEY',
});
const mcpToolDefinitions = await client.mcpTool.getMcpTools('oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD', {
 mcp_id: 'mcp-server-1',
});
console.log(mcpToolDefinitions);

```

[(3)](https://docs.retellai.com/api-references/get-mcp-tools)

The issue is usually an MCP server configuration or authentication problem rather than a Retell AI platform issue[(1)](https://discord.com/channels/1186424376300679209/1419610738116264076).