> For the complete documentation index, see [llms.txt](https://mcp-docs.nichefire.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mcp-docs.nichefire.com/overview/capabilities.md).

# Capabilities

The Nichefire MCP server provides any MCP-compatible AI assistant—including Claude.ai, Claude Desktop, Claude Code, ChatGPT, and custom agents—with direct access to Nichefire’s trend intelligence.

Once connected, users can submit requests in natural language. The assistant determines which Nichefire capability to use and incorporates the results into the conversation.

### Available Capabilities

The server provides two main groups of capabilities:

* **Firesearch** - Live trend research across the public web.
* **Insights API** - Access to the trend intelligence your organization already tracks within Nichefire dashboard.

#### Firesearch

Firesearch searches news sources, social platforms, and the open web to identify and explain emerging trends using current information.

A typical workflow begins with a trend search. The user can then select a result and request a more detailed analysis.

| Capability                 | What it does                                                                                                                                            | Ask your assistant something like                                       |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| **Search for trends**      | Runs a research query and returns a ranked list of trends, each with a title, description, date, source platforms, source links, and a relevancy score. | *"What are the emerging trends in sustainable packaging this quarter?"* |
| **Analyze a single trend** | Produces a deep dive on one trend: what it is, why it is happening, how interest has evolved over time, and how the web is talking about it.            | *"Take the second trend from that list and analyze it in depth."*       |

A typical flow is to search first, then pick one result and ask for the deep analysis.

**Research effort**

Trend searches support two modes:

**Instant (default)** — Provides fast, responsive results suitable for interactive conversations and follow-up questions.

**Thinking** — Performs a slower and more comprehensive research process, producing more detailed and thoroughly sourced results.

> ChatGPT connectors may mostly run in **instant** mode, regardless of what is requested, because deeper runs exceed its tool-call time budget. Claude.ai, Claude Desktop, and Claude Code support both modes.

#### Insights API

The server can access the trend topics and individual trends your organization already tracks within Nichefire. This is organization-specific data rather than content obtained from the public web.

Topics and trends are identified by ID. A typical workflow involves listing the available topics, retrieving the trends within a selected topic, and opening the relevant trend. The AI assistant can perform and chain these steps automatically.

| Capability                 | What it does                                                                                                         | Ask your assistant something like                          |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **List trend topics**      | Browse the topics your organization monitors.                                                                        | *"Which trend topics are present in our organization?"*    |
| **Get a topic**            | Full detail of one topic, including which of its trends are rising and which are sustaining.                         | *"Show me the detail of the 'Gen Z beauty' topic."*        |
| **List trends in a topic** | The trends under a topic, filterable by date range and status (active or stopped), in ascending or descending order. | *"List the active trends under that topic since January."* |
| **Get a trend**            | Full detail of one trend: summary, themes, keywords, sentiment, trajectory, and volume.                              | *"Give me everything on that first trend."*                |

#### Usage visibility

The server provides access to current usage information, allowing users to review their organization’s remaining allowance.

| Capability      | What it does                                                                                 | Ask your assistant something like              |
| --------------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **Check usage** | Reports how much of your allowance is currently available, broken out per capability family. | *"How much Nichefire search do we have left?"* |

### How results come back

Every capability returns structured data. This allows the assistant to reference exact figures, follow source links, and pass the output of one request into subsequent calls without relying on prose summaries.

Clients that support rich output may display the results through native visual components. Simpler clients receive the same information in readable JSON format.

### Good to know

**Read-only access.** All available capabilities retrieve or research information. They cannot create, modify, or delete data within your Nichefire workspace.

**Remote access only.** The server is accessed over HTTPS. There is no local application to install, run, or update.

**Complete results.** Deep-research requests return a single completed response rather than streaming partial progress. Thinking-mode searches may take noticeably longer than instant searches.

**Access-based availability.** The assistant lists only the capabilities included in your organization’s access level. No additional configuration is required. If an expected capability is unavailable, contact your Nichefire account manager.