Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fuser-guides%2Fmcp-server%2Ftools%2Freference.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fuser-guides%2Fmcp-server%2Ftools%2Freference.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

# Reference tools

The MCP server provides foundational tools for understanding and querying your data effectively.

### Explore DataPrime commands and functions[​](#explore-dataprime-commands-and-functions "Direct link to Explore DataPrime commands and functions")

Use the `list_dataprime_commands` tool to browse the available DataPrime commands and functions, and the `show_dataprime_command_details` tool to see the syntax, description, and category for a specific one. These tools help AI agents construct correct queries with DataPrime, Coralogix's structured query language for logs, traces, and metrics. They are based on the [DataPrime Reference](https://docs-docusaurus.kinsta.page/dataprime/introduction/welcome-to-the-dataprime-reference/.md).

Explore the relevant commands **before** running queries with `query_dataprime` and `query_promql_range` to ensure correct syntax and interpretation.

**`list_dataprime_commands` parameters:**

| Name   | Required | Type   | Description                                                                   |
| ------ | -------- | ------ | ----------------------------------------------------------------------------- |
| `kind` | No       | enum   | One of `all` (default), `commands`, or `functions`.                           |
| `name` | No       | string | Case-insensitive substring to filter the catalog by command or function name. |

**`show_dataprime_command_details` parameters:**

| Name   | Required | Type   | Description                                             |
| ------ | -------- | ------ | ------------------------------------------------------- |
| `kind` | Yes      | enum   | One of `all`, `commands`, or `functions`.               |
| `name` | Yes      | string | The exact command or function name to show details for. |

### Discover fields with `search_for_fields`[​](#discover-fields-with-search_for_fields "Direct link to discover-fields-with-search_for_fields")

Use the `search_for_fields` tool to discover the log and span field paths ([keypaths](https://docs-docusaurus.kinsta.page/dataprime/user-guide/foundations/understanding-logs/.md): `$d`, `$l`, `$m`) in your data before writing complex queries. Search by field description, by an example value, or by a batch of both—up to five searches per call.

**Example:**

```
{

  "search_items": [

    { "description": "http status code" },

    { "value": "payment-service" }

  ],

  "source": "logs"

}
```

**Parameters:**

| Name           | Required | Type  | Description                                                                                                                                                                              |
| -------------- | -------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_items` | Yes      | array | Up to five search items. Each item has either a `description` (semantic search over field descriptions) or a `value` (case-insensitive substring match on example values), but not both. |
| `source`       | No       | enum  | One of `logs` (default) or `spans`.                                                                                                                                                      |

**Helpful hints:**

* Use `description` searches to find fields by meaning, and `value` searches to find which field contains a known value.
* To discover metrics instead of log or span fields, use [`search_relevant_metrics`](https://docs-docusaurus.kinsta.page/user-guides/mcp-server/tools/metrics/.md).

### Get the current time with `get_datetime`[​](#get-the-current-time-with-get_datetime "Direct link to get-the-current-time-with-get_datetime")

Use the `get_datetime` tool to retrieve the current date and time. This is useful for constructing time-bounded queries when you need a reference to the present moment.