A tool appears as Unknown Tool
Update the installed integration and check one redacted hook entry when an agent omits its tool name.
Unknown Tool means Agent Approve received an action without a usable tool name. The action still follows your active policy. Agent Approve does not force an approval, denial, or prompt because the name is missing.
When the action includes a valid MCP server identity, Agent Approve keeps it. An approval request can show Server name / Unknown Tool, and the event details keep the server information. Without an MCP server identity, the action appears as a native Unknown Tool.
Update and test the integration
-
Run the installer again:
npx agentapprove install -
Keep your current setup choices when prompted. The installer refreshes the hooks and plugins for the integrations you select.
-
Quit the affected agent session, then start a new one. If the integration does not reload, quit and reopen the native agent app.
-
Ask the agent to perform one harmless action.
-
Open the Agent Approve activity feed. The new action should show its real tool name.
An older event can continue to show Unknown Tool. The success check applies to actions created after the update and session restart.
If the name is still missing
Enable the hook debug log and repeat one harmless action. Find the short section for that action and check whether the raw hook input includes a tool-name field.
The debug log can contain commands, paths, prompts, tool arguments, output, and other private work. Do not send the complete file. Copy only the smallest section around the test, remove private content and credentials, and include the agent name and version when you contact Support.
If the updated action still appears as Unknown Tool, send that short redacted excerpt to Support. Subsequent actions showing their real tool name confirm that the integration is working normally.