Skip to main content
If your client connects successfully but doesn’t show the tools you expect, the issue is usually related to publishing, tool configuration, or the client’s cached capability list.

​
1. Verify the tool is enabled

Open Tools and confirm that the tool is enabled. Disabled tools aren’t advertised to MCP clients.

​
2. Check the published version

Only the published version of your MCP server is visible to connected clients. If you’ve recently added or edited a tool, make sure the version containing those changes has been published. Saving a draft or creating a version alone isn’t enough.
A saved draft does not update the tools available at the live MCP endpoint. You must publish the version that contains the changes.

​
3. Confirm the API operation was imported

If a tool doesn’t exist at all, verify that the corresponding API operation was selected during the OpenAPI import. Operations that weren’t imported won’t appear as MCP tools.

​
4. Review the tool configuration

Check that the tool has:
  • A valid name
  • A clear description
  • No duplicate tool names
Invalid or conflicting tool definitions can prevent clients from displaying them correctly.

​
5. Refresh the client

Many MCP clients cache the list of available capabilities. After publishing changes:
  • Restart or reconnect the MCP server.
  • Refresh the tool list if your client supports it.
  • Start a new conversation or session if tools still don’t appear.
Reconnecting forces the client to request the published capability list again.

​
6. Check client compatibility

Some MCP clients may not support every possible input schema. If a tool has a complex or unsupported input shape, the client may choose not to display it. Review your tool’s input definition and, if possible, simplify it.

​
Still missing?

If the tool still doesn’t appear:
  1. Confirm the latest version is published.
  2. Verify the tool is enabled.
  3. Reconnect the client.
  4. Check Logs to confirm the client successfully refreshed the server’s capabilities.
If the client is connected but continues to display an outdated tool list, completely remove the MCP server from the client, add it again using Client setup, and start a new conversation.