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

# search_assets

> Full-text search across your Versuno assets with relevance scoring.

Performs a full-text search across your Versuno assets and returns results ranked by a compound score of relevance, importance, and recency. Metadata only — no content is loaded into context.

## Input

| Parameter | Type   | Required | Description                                                                                           |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| `query`   | string | Yes      | Search query. Specific keywords work better than general phrases.                                     |
| `type`    | enum   | No       | Filter results to a specific asset type: `context`, `skill`, `persona`, `prompt`, or `system_prompt`. |
| `limit`   | number | No       | Max results. Default 10, max 20.                                                                      |

## Example

**Prompt:**

> *"Search Versuno for anything about customer support."*

**Tool call:**

```json theme={null}
{
  "query": "customer support"
}
```

**Response:**

```
Found 4 matches:

- abc123  [prompt]  "Support reply template" (score: 0.92)
- def456  [skill]   "Ticket triage skill" (score: 0.81)
- ghi789  [context] "Support team onboarding" (score: 0.67)
- jkl012  [persona] "Support agent persona" (score: 0.58)
```

## When to use it

* The agent has a specific topic in mind and needs the best match.
* You want to find related assets before loading them (rather than loading blindly).
* Use together with [get\_asset](/mcp/tools/get-asset) or [pull\_asset](/mcp/tools/pull-asset) as a follow-up.

## Search tips

* Use specific nouns and verbs. "onboarding SQL queries" beats "help me with databases".
* Add type filter if you know what you want. Searching only `prompt` reduces noise.
* The scoring favours recently updated assets with a high importance rating.

## See also

* [list\_assets](/mcp/tools/list-assets) — browse without a query.
* [get\_asset](/mcp/tools/get-asset) — load the content of a specific match.