# Newslit MCP

> Newslit lets your AI client treat it like a full market intelligence dashboard. You connect your API key and gain control over news monitoring, media impact analysis, and press discovery directly from chat. Use tools like `list_reports` to see all active research environments, or run `create_report` to track brand mentions across specific industries instantly.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** media-monitoring, news-intelligence, press-clipping, market-research, content-tracking

## Description

Newslit gives your AI client full command over market intelligence. You connect your API key, and suddenly you've got a whole media monitoring dashboard right in your chat window. Forget wrestling with complex web UIs; here, you just talk to it.

**Managing Your Research Setup**

You gotta know what reports are running before you start digging. To see everything you’ve set up, you run `list_reports`. That tool spits out a list of every single news report you're currently tracking or have saved for later. If you need to check the deep setup—the specific filters and criteria—for one particular project, you use `get_report` with its unique name. This grabs all the configuration details so you know exactly what it’s looking for. You can also modify those search parameters anytime using `update_report`. If a topic shifts or your focus changes, you just update the filters or tweak the exclusion criteria on an existing report without having to rebuild the whole thing.

If you're done tracking something—maybe the market cooled off or the project got shelved—you hit `delete_report`. That tool cleanly removes that news monitoring job from your monitored list. To start fresh, you use `create_report`. Just feed it the topic data in JSON format, and Newslit builds a brand new report for you to monitor.

**Retrieving the Data You Need**

The real payoff is getting the stories. When you need the latest headlines or articles tied to a specific monitoring job, you call `list_stories`. This tool pulls the actual content associated with a given report ID, letting you track shifts in industry chatter or see what your competitors are up to right now.

These retrieved stories don't just give you a headline. They include source names and direct URLs to the original articles. You know exactly where every piece of information came from. You can process these sources and links through your agent, which makes tracking media impact immediate. You use this capability to analyze coverage across specific industries or confirm brand mentions instantly. The whole cycle—from listing existing reports to creating a new one, updating its parameters, pulling the stories, and even deleting it when you're done—it all happens directly within the chat flow.

## Tools

### create_report
Builds a new news monitoring report based on the topic data you provide as JSON.

### delete_report
Removes an existing news report from your monitored list.

### get_report
Retrieves the full configuration details for a specific, named report.

### list_reports
Returns a list of all news reports you currently have active or saved.

### list_stories
Pulls the latest headlines and articles associated with a specific monitoring report ID.

### update_report
Changes the topic filters or exclusion criteria for an already existing news report.

## Prompt Examples

**Prompt:** 
```
List all my news reports in Newslit.
```

**Response:** 
```
I've retrieved your reports. You have 3 active environments: 'Tech Trends', 'Industry Rivals', and 'Sustainability'. Which one would you like to see stories from?
```

**Prompt:** 
```
Get the full details and story coverage for report ID rpt_4521.
```

**Response:** 
```
Report "Q1 Brand Mentions" (rpt_4521) contains 147 stories collected over the last 90 days. Top sources include Reuters (12 mentions), TechCrunch (8 mentions), and Bloomberg (6 mentions). Overall sentiment is 72% positive, 18% neutral, and 10% negative.
```

**Prompt:** 
```
Create a new media monitoring report tracking mentions of artificial intelligence in tech news.
```

**Response:** 
```
Your new report "AI Media Monitor" has been created successfully with ID rpt_4589. It is configured to track the keyword "artificial intelligence" across all indexed tech news sources. Initial results are being collected and should populate within the next few minutes.
```

## Capabilities

### Manage Report Lifecycle
Create, read, update, or delete entire news monitoring reports using simple commands.

### List All Reports
Retrieve a comprehensive list of every single news report you have set up in Newslit.

### Fetch Story Collections
Pull the latest stories and headlines from any specific monitoring report to track trends.

### Get Report Metadata
Access detailed configuration data for a report, confirming its filters and status.

### Discover Sources & Links
Pull stories that include source names and direct URLs to the original articles.

## Use Cases

### Tracking a Major Competitor
A market researcher needs to monitor how their main competitor is being discussed. They use `create_report` with specific keywords and launch it. Later, they prompt the agent to run `list_stories`, immediately seeing every mention across tech news sites without manual searching.

### Auditing Old Campaigns
A PR team needs to know what was said about them six months ago. They use `list_reports` to find the 'Q1 Brand Mentions' report ID, then run `get_report` to check its status and configuration before pulling historical data.

### Pivotting Strategy Mid-Quarter
Product managers realize they need to focus on a new vertical (e.g., 'Sustainable energy'). They use the agent to run `update_report` on their existing report, changing just the keywords and exclusions instantly, rather than starting from scratch.

### Cleaning Up Research Data
An analyst realizes a specific news source is polluting one of their reports. They use `list_reports` to confirm the ID, then invoke `delete_report` to cut it out entirely, keeping the rest of their monitoring intact.

## Benefits

- Keep your research current using `list_stories`. Instead of checking source websites, you ask your agent for stories related to 'Industry Rivals' and get the latest headlines in seconds. It saves hours of browsing.
- Build targeted intelligence with `create_report`. Define a new monitoring scope—say, 'AI ethics in healthcare'—and Newslit immediately starts gathering mentions across all indexed sources.
- Maintain clean records by using `list_reports` and `get_report`. You can verify exactly what filters are active on which reports, stopping data collection on old or irrelevant topics.
- Fine-tune your research with `update_report`. If a report starts getting noise from an unwanted source, you just use the update tool to refine its topic filter without rebuilding the whole thing.
- Know your sources. When fetching stories using the API, Newslit provides detailed source information and direct links, so you always know where the article came from.

## How It Works

The bottom line is: your AI client becomes a dedicated market researcher, running complex API calls through simple conversation prompts.

1. First, subscribe to the Newslit server and input your API Key from the Newslit dashboard settings.
2. Next, prompt your AI client (Claude, Cursor, etc.) to execute a task—for example, 'List all my news reports.'
3. The agent calls the appropriate tool (`list_reports`), processes the data, and presents you with actionable findings in the chat window.

## Frequently Asked Questions

**How do I start monitoring new topics using Newslit MCP Server?**
You use the `create_report` tool. Just tell your agent what topic you want to track and provide the necessary JSON data, and it sets up the initial monitoring scope for you.

**I need to check all my active reports in Newslit MCP Server.**
Run `list_reports`. This tool returns a list of every report ID and name you've set up, letting you see what data is currently being monitored.

**How do I get the full story details for an existing report?**
Use the `get_report` tool, feeding it the specific report ID. This returns all configuration metadata, including its current filters and status.

**Can I change what a monitoring report tracks? (update_report)**
Yes, you use the `update_report` tool. You pass in the existing report ID and the new filter criteria (keywords, exclusions), which updates the tracking without deleting the whole setup.

**What is the difference between list_stories and list_reports?**
`list_reports` gives you a list of your *environments* (the report IDs). `list_stories` takes one of those environments and pulls out all the actual, current news stories from it.

**If I no longer need a monitoring setup, how do I completely remove it using the `delete_report` tool?**
You use `delete_report(report_id)` to permanently remove a report. This action immediately deactivates all associated news monitoring and deletes the configuration metadata. Be aware that deleting a report removes access to its stored story data, so confirm you don't need historical records first.

**What specific structure must I pass when running the `create_report` function?**
The `create_report` tool requires all parameters—like topic, keyword list, and source types—to be passed as a single JSON string. You need to format this data precisely so your agent knows exactly what criteria define the new monitoring scope.

**When I run `list_stories`, what metadata does it return for each news item?**
The tool returns more than just headlines. For every story, you get detailed source information, a direct link to the original article, and key metrics like the date collected and any associated sentiment analysis.

**Can my AI automatically find the latest stories for a specific report by its ID?**
Yes! Use the `list_stories` tool with the Report ID. Your agent will respond with complete metadata for the newest stories, including headlines, summaries, and source links in seconds.

**How do I find my Newslit API Key?**
Log in to your Newslit account, navigate to **Integrations** > **News API**, and you will find your unique secret token (X-NewslitApiKey) there.

**Does the API provide full article text?**
The API primarily provides headlines, curated summaries, and source metadata. Direct links are provided to access the full content on the original publisher's website.