> For the complete documentation index, see [llms.txt](https://docs.autommate.com/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/library-search-actions.md).

# library\_search\_actions — Find integration actions

**Declared contract — reviewed 21 October 2026.** This page describes the tool exposed by the Autom Mate New connection in the inspected 71-tool profile. It does not establish support on every build or prove runtime success. Check the active connection and [installed product version](https://docs.autommate.com/userguide/start-here/documentation-scope-and-product-versions.md). Historical examples retain their original observation dates. Logical tool names may have a client-specific namespace prefix.

Find actions across the licensed catalogue. The query matches whole words in action labels. Browse the application first with `libraries_search` if its catalogue structure is unclear.

## Declared request signature

The following is the exposed 21 October declaration; request types do not define an exhaustive response schema.

```ts
declare const tools: { mcp__codex_apps__autom_mate_new_library_search_actions(args: { application?: string; cursor?: string; page_size?: number; query?: string; }): Promise<CallToolResult>; };
```

## Parameters

| Parameter     | Type   | Required | Meaning                     |
| ------------- | ------ | -------- | --------------------------- |
| `application` | string | No       | Application filter.         |
| `query`       | string | No       | Action label search.        |
| `page_size`   | number | No       | Requested page size.        |
| `cursor`      | string | No       | Returned pagination cursor. |

## Minimal request

“Assign” is an illustrative action-label search used in the worked guide. Multiple libraries can have an Assign action; choose the result for the intended library.

```json
{
  "query": "Assign"
}
```

## Read the result

* Use the returned `action_ref` with `library_get_action`. Labels identify records for display; they are not valid replacements for the reference.
* Only use references returned by this search. Do not invent or recall an `action_ref` from a previous environment.
* Restricted catalogue entries are omitted. A missing match therefore reflects both the search and the available licence, not necessarily the product's full catalogue.
* Present the matching actions and their relevant labels without inventing an explanation for the search engine's match or ranking.
* For another page, keep the same filters and pass the returned cursor unchanged. Treat the cursor as opaque; stop when no continuation is returned. The first page need not be the complete result set.

## Permissions and retries

Read-only, licence-scoped discovery. Reading an action does not add it to a flow or execute it. Resolve permission or search errors before continuing; do not retry with guessed identifiers.

## Present a requested result

When the user asked to see this result, pass the returned `result_ref` to `show_result` once for the final requested answer. Do not show cards for intermediate lookups. A result reference expires after 15 minutes; read again if it has expired. This presentation step neither executes nor verifies a business action.

## Continue

* Next tools: [`library_get_action`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/library-get-action) · [`libraries_search`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/libraries-search).
* Workflow: [Discovery tool contracts](https://docs.autommate.com/userguide/mcp-and-ai-reference/discovery-tool-contracts.md).
* Worked reference: [Read discovery results and pagination](https://docs.autommate.com/userguide/mcp-and-ai-reference/read-discovery-results-and-pagination.md).
* Worked reference: [Read Hyperflow and action input contracts](https://docs.autommate.com/userguide/mcp-and-ai-reference/read-hyperflow-and-action-input-contracts.md).
* [MCP tool reference](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools).
