This page documents the tools exposed by the DataGalaxy MCP server, including their parameters and usage notes. The server exposes 14 tools for browsing workspaces, searching the catalog, reading/updating objects, and managing comments, tasks, tags, technologies, users, and data sources.
1. list_workspaces_and_versions
List every workspace with its versions. Call this first to resolve scope (workspace_id / version_id) for all other tools.
| Parameter | Type | Required | Description |
|---|---|---|---|
| include_archived | boolean | No (default: false) | Include archived versions in each workspace's version list. |
2. search_objects
Search catalog objects by free-text name and a few basic filters (name, description, summary, synonyms).
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Free-text search across name, description, summary, synonyms. |
| entity_type | string | No | Object type filter (e.g. Table, BusinessTerm, DataProduct, Column, Application, etc.). |
| module_name | string | No | Module filter: AiProduct, Processing, DataProduct, Diagram, Catalog, Glossary, Initiative, Objective, Policy, RuleAndMonitor, Usage. |
| creation_time_operator | enum | No | Named creation-date period filter (e.g. pastWeek, currentMonth). |
| modification_time_operator | enum | No | Named modification-date period filter. |
| workspace_id | string | No | Scope search to a workspace. |
| version_id | string | No | Scope to a specific version (requires workspace_id). |
| limit | integer | No (default: 20, max 50) | Results per page. |
| page | integer | No (default: 1) | Page number. |
3. semantic_search
Search catalog objects by semantic similarity (topic/concept based, e.g. "finance-related objects").
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Complete, standalone query folding in all relevant conversational context. |
| workspace_id | string | No | Scope search to a workspace. |
| version_id | string | No | Scope to a specific version (requires workspace_id). |
| limit | integer | No (default: 20, max 50) | Results per page. |
| page | integer | No (default: 1) | Page number. |
4. get_object
Overview card for one catalog object: attributes, location, and relation counts/samples (links, children, fields).
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
| include_writability | boolean | No (default: false) | Also report which attributes are writable/empty. |
5. get_object_attributes
Lists the attributes an object can carry, their formats, and legal values. Call before update_object.
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
6. update_object
Change one or more attributes of a catalog object.
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the object to update. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
| attributes | object | Yes | Flat {name: value} map of attributes to change. Lists (owners, stewards, tags) replace the current value. |
7. get_object_relations
Page through one relation of a catalog object: links, children, fields, or ancestors.
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object. |
| relation | enum | Yes | One of: links (relationships), children (hierarchy), fields (columns/structure), ancestors (parent chain). |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
| limit | integer | No (default: 20, max 50) | Items per page. |
| page | integer | No (default: 1) | Page number. |
8. get_comments
List the comments on one catalog object (author, timestamp, message text).
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
9. create_comment
Create a new comment on a catalog object. Note: does not support tagging users or teams.
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object to comment on. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
| message | string | Yes | Comment text (HTML/rich-text markup allowed). |
10. get_tasks
List the tasks attached to one catalog object (title, description, status, type, assignee/creator, due date).
| Parameter | Type | Required | Description |
|---|---|---|---|
| object_id | string (UUID) | Yes | UUID of the catalog object. |
| workspace_id | string | Yes | Workspace scoping the object. |
| version_id | string | Yes | Version scoping the object. |
11. get_tags
List every tag defined in the catalog (cross-workspace vocabulary). Takes no arguments.
| Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
12. get_technologies
List the technologies defined in the catalog (e.g. PostgreSQL, Snowflake, Azure Data Lake). Takes no arguments.
| Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
13. get_users
List catalog users, used to resolve a person into a user ID before setting an owner/steward.
| Parameter | Type | Required | Description |
|---|---|---|---|
| first_name | string | No | Filter by first name (exact match). |
| last_name | string | No | Filter by last name (exact match). |
| limit | integer | No (default: 20, max 50) | Results per page. |
| page | integer | No (default: 1) | Page number. |
14. get_data_sources
List the top-level data sources (databases, file stores, NoSQL stores) in a version.
| Parameter | Type | Required | Description |
|---|---|---|---|
| version_id | string | Yes | Version scoping the listing. |
| limit | integer | No (default: 20, max 50) | Results per page. |
| page | integer | No (default: 1) | Page number. |