fulltext_search_model_elements
Performs intelligent full-text search across model elements using the server's native search engine with relevance ranking to find the most pertinent matches.
Purpose
This tool searches element names, qualified names, and properties, returning results ordered by relevance score (higher scores indicate better matches). Ideal for quick element discovery when you know part of the name or description but don't need complex regex patterns or type filtering. Supports pagination, sorting, and filtering options to exclude library or project usage elements.
Tags: AM Read Advanced
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id |
string | Yes | - | Project name or UUID |
ref_id |
string | Yes | - | Commit UUID, branch name, or tag name |
search_text |
string | Yes | - | Text to search for |
exclude_library_project |
boolean | No | false | Exclude library elements |
exclude_project_usage |
boolean | No | false | Exclude used project elements |
sort_by |
string | No | null | Field to sort by |
sort_order |
string | No | "ASC" | "ASC" or "DESC" |
limit |
integer | No | 100 | Max results per page (1-500) |
page |
integer | No | 1 | Page number |
Output schema
| Field | Type | Description |
|---|---|---|
| summary.project_id | string | UUID of the project being searched |
| summary.ref_id | string | Branch or commit ID used for the search |
| summary.resolved_commit_id | string | Actual commit UUID resolved from the ref_id |
| summary.search_text | string | The search text that was used |
| summary.total_matches | integer | Total number of elements matching the search criteria |
| summary.returned_count | integer | Number of elements returned in this response |
| summary.page | integer | Current page number |
| summary.limit | integer | Maximum results per page |
| summary.has_more | boolean | Indicates if more results are available on subsequent pages |
| summary.search_method | string | Search algorithm used (e.g., "server_quick_search") |
| matching_names_preview[].name | string | Name of a matching element |
| matching_names_preview[].rank | number | Relevance rank score (0.0-1.0, higher is more relevant) |
| elements[].elementId | string | Unique identifier for the element |
| elements[].name | string | Display name of the element |
| elements[].actual_name | string | Actual declared name of the element in the model |
| elements[].elementType | string | SysML v2 type of the element (e.g., PartUsage, AttributeUsage) |
| elements[].search_rank | number | Relevance rank score for this element (0.0-1.0) |
| elements[].browser_url | string | Clickable URL to view the element in the web browser |
Common use cases
- Quick element search
- Find elements by name or description. Example: "Find all elements containing 'power'.
- Relevance-based discovery
- Get most relevant matches first. Example: "Search for 'battery' and show best matches".
- Cross-model search
- Search across entire model with ranking. Example: "Find all references to 'voltage'.