# KnowFirst MCP

> KnowFirst helps you gather proprietary market intelligence, profiling entire companies or individuals against real-time data signals. You can build a complete profile on any entity, map out its connections to parent companies and partners, track historical changes over time, and analyze sector-wide trends across categories like Fintech or Energy.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** entity-profiling, market-intelligence, signal-tracking, institutional-research, data-intelligence

## Description

Need to know what's actually happening with a target company? This MCP connects your agent to KnowFirst, providing deep intelligence profiling. You can search for any entity to pull a complete data profile, see which sources built that information, and even map out all the people and companies connected to it. If you suspect something is changing—say, an acquisition or a shift in leadership—you don't have to guess; you audit historical changes on that specific entity. For broader views, you can pull current market trends by category, letting you understand where a whole sector is moving. All this complex data gathering gets organized through Vinkius, so your agent pulls it all together using natural language commands.

## Tools

### search_intelligence_entities
Finds unique entity IDs by searching across the entire intelligence database.

### get_entity_profile
Retrieves the full intelligence profile for any given entity ID.

### list_intelligence_sources
Lists all the specific sources—like news or public records—that contributed to the intelligence data.

### query_custom_intelligence
Executes a highly customized, targeted query using structured JSON parameters.

### audit_entity_changes
Checks and returns a record of an entity's historical data changes.

### list_entity_data_points
Retrieves a list of raw, underlying data points used for an entity's profile.

### get_market_intelligence_trends
Pulls current market trends based on a specified industry category.

### search_data_sources
Allows you to search the database for specific types of data sources.

### get_entity_connections
Generates a graph showing all known relationships connected to an entity.

### check_knowfirst_api_status
Verifies the current operating status of the KnowFirst API connection.

## Prompt Examples

**Prompt:** 
```
Research Acme Corp in KnowFirst
```

**Response:** 
```
I've found Acme Corp (ID: ent_123). It has a very high confidence score. Intelligence shows a recent expansion in Europe and a positive news sentiment trend. Would you like to audit their connections?
```

**Prompt:** 
```
Show me the connections for entity 'ent_123'
```

**Response:** 
```
Mapping relationships for 'ent_123'… I found 8 strong connections, including 3 parent companies and 5 strategic partners. I've highlighted the most critical nodes for your review.
```

**Prompt:** 
```
What are the trending signals in the 'Fintech' category?
```

**Response:** 
```
The Fintech sector is currently showing a surge in 'Regulatory Change' signals and a decline in 'Early-stage Funding' reports. Most activity is concentrated in the US and Brazil.
```

## Capabilities

### Build an entity profile
Get a complete intelligence summary on any company or person.

### Map out relationships
Graph the connections between an entity and its associated partners, parent companies, or subsidiaries.

### Analyze historical shifts
Track exactly how an entity's data or status has changed over time.

### Monitor market trends
Pull current sector-wide signals and movement patterns by industry category.

### Query specific intelligence
Run custom queries using structured parameters to isolate niche data points.

## Use Cases

### A competitor suddenly changes its board structure.
The strategy team asks: 'Why did Acme Corp replace their CEO last quarter? What were the connections that changed?' The agent uses `get_entity_profile` and then `audit_entity_changes` to pinpoint the exact dates and roles of departure, revealing a clear pattern of executive instability.

### Vetting an M&A target with unknown ties.
The investment team needs full visibility on TargetCo. They run `search_intelligence_entities` first to confirm the ID, then use `get_entity_connections`. This quickly maps out all 12 subsidiaries and their shared ownership links, eliminating due diligence blind spots.

### Identifying a potential new market segment.
The research team wants to know what's hot in the industry. They ask for `get_market_intelligence_trends` filtered by 'Biotech'. The results show an unexpected surge in signals related to CRISPR technology, giving them immediate direction for a pitch deck.

## Benefits

- You don't just get a profile; you see the data sources. Using `list_intelligence_sources` shows exactly where the information came from, letting you audit the quality of the underlying research.
- When you suspect an entity is doing something shady or pivoting strategy, use `audit_entity_changes`. This tool lets you track behavioral shifts over time that simple status checks miss.
- Need to know who a company works with? `get_entity_connections` maps out every relationship—parent companies, suppliers, and strategic partners—in one graph view.
- If your query is too niche for standard reports, use `query_custom_intelligence`. It lets you pass specific JSON parameters to target exact pieces of data you need.
- Understanding the big picture? Run a category search using `get_market_intelligence_trends` to see where entire sectors are heading right now.

## How It Works

The bottom line is: your agent translates complex research questions into actionable data retrieval sequences.

1. You start by instructing your agent to search for a specific entity, which returns its unique ID.
2. Next, you direct the agent to pull the complete profile or map connections using that ID.
3. Finally, the system delivers the structured intelligence data—whether it's raw data points or relationship graphs—right back to your workflow.

## Frequently Asked Questions

**How do I find out what an entity was doing last year using KnowFirst?**
Run the `audit_entity_changes` tool. This function looks back at historical records for a specific ID, showing you exactly how their data or status has changed over time.

**Is there a way to see all the data sources used in a profile?**
Yes. Use `list_intelligence_sources`. This function explicitly lists every source—like Public Records or Social Signals—that contributed information to the entity's intelligence profile.

**What if I need data on a brand new, unlisted company?**
Start by using `search_intelligence_entities`. This tool searches across the entire database and helps you find a unique ID for entities that might not be obvious to search for directly.

**Can I ask questions that mix market trends with specific company data?**
Yes. You can combine tools like `get_market_intelligence_trends` with `get_entity_profile`. For instance, you can see if a target company's sector is currently surging or declining.

**If I use `list_entity_data_points`, what format will the raw intelligence data be in?**
The data comes back as a structured JSON object. This means you'll get clearly labeled fields for every piece of information, making it easy to process into your own databases or scripts.

**When running complex reports via `query_custom_intelligence`, are there any rate limits or throttling concerns?**
KnowFirst handles high-volume queries through an asynchronous job queue. If you submit too many requests too quickly, the MCP will return a pending job ID, which you can then poll to retrieve your results later.

**When using `get_entity_connections`, can I specify which type of dependency (e.g., parent company or strategic partner) I want to map?**
Yes, the tool allows you to filter connections by relationship type. This means you won't just get a flood of links; you can specifically target the most critical relationships for your analysis.

**Can I use `search_intelligence_entities` to look for entities based on shared keywords, rather than just unique IDs?**
Absolutely. While it primarily searches by ID, you can pass keyword parameters through the tool's query fields. This lets you find multiple potential matches even if you don't have a specific entity name or identifier.

**How do I find an Entity ID?**
Use the `search_intelligence_entities` tool with the name of the company or person. It will return a list of matches with their IDs.

**What kind of signals does KnowFirst track?**
KnowFirst tracks financial events, leadership changes, social media mentions, news sentiment, and operational shifts.

**Can I query raw data points?**
Yes, use the `list_entity_data_points` tool to see the underlying observations recorded for any entity.