# Tools

> **Admin Only** — This page is for system administrators who configure Nova tools.

Tools are the actions Nova can perform in your system — looking up records, creating documents, running reports. Each tool has a defined set of inputs and outputs.

## Built-In Tools

Nova comes with several tools pre-configured:

| Tool                | What It Does                         | Risk Level  |
| ------------------- | ------------------------------------ | ----------- |
| **Get Document**    | Retrieve a specific record by name   | Read Only   |
| **Get All**         | Search and list records with filters | Read Only   |
| **Create Document** | Create a new record                  | Write       |
| **Update Document** | Modify an existing record            | Write       |
| **Delete Document** | Remove a record                      | Destructive |
| **Run Report**      | Execute a report with filters        | Read Only   |

## Creating a Custom Tool

1. Go to **Nova Tool** list
2. Click **+ Add Nova Tool**
3. Fill in:
   * **Tool Name** — unique identifier
   * **Label** — display name (what users see)
   * **Description** — what the tool does (helps Nova decide when to use it)
   * **Tool Type** — Frappe API, Custom Python, or MCP External
   * **Input Schema** — JSON Schema defining the tool's parameters
   * **Risk Level** — Read Only, Write, or Destructive
4. Toggle **Enabled** on
5. Click **Save**

![built in tools](/files/yH8NaBbR4da6KIW56v3E)

![create custom tool (step 1)](/files/8WJAipQTqUKbGk7fyNXE)

![create custom tool (step 2)](/files/bC7njitysbMXy7w8nZw1)

![create custom tool (step 3)](/files/lItTxl2zoWnvyGgq1dP1)

![enable and save (step 1)](/files/1hcbum3awsy7ncCXW8rF)

![enable and save (step 2)](/files/jYbCKI2ZBr0NVkk76qMI)

![input schema (step 1)](/files/G6i7C6QqJh7QIc6nHoql)

![risk level (step 1)](/files/i6wd7NcN2QjhMluHQqV6)

![tool list](/files/X2eTTkGZzUwBt2LdPHeK)

![tool type (step 1)](/files/Tkm6momQzVk3OM5o7vZX)

## Related Pages

* [Configuring Agents](/nova-ai-assistant/nova/configuring-agents.md)
* [Nova Settings](/nova-ai-assistant/nova/settings.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proforgeerp.com/nova-ai-assistant/nova/managing-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.