---
title: "Clearer MCP tool descriptions | Narwhal API"
description: "Every input of every MCP tool now has a description, and each tool says when to pick it over its sibling."
url: "https://narwhalapi.com/changelog/mcp-tool-descriptions"
---

# Clearer MCP tool descriptions

Every input of every MCP tool now has a description, and each tool says when to pick it over its sibling.

November 20, 2026

Every input of every MCP tool now has a description, and each tool says when to pick it over its sibling.

## What changed

- All 814 inputs across the 128 tools are described, with the default, maximum and range added from the schema. 523 had no description before.
- Each tool carries one sentence on when to use it instead of a similar tool, such as latest against history.
- Rewrote the descriptions of fx_get_rate_history, commodities_get_physical_latest, commodities_get_physical_series, economics_get_trade, filings_list_company_filings and predictions_list_events.
- The REST routes and their schemas are unchanged.

[All changelog entries](https://narwhalapi.com/changelog.md) · [Changelog RSS feed](https://narwhalapi.com/changelog/feed.xml)

Was this page helpful?
