# Mattermark MCP

> Mattermark connects your AI agent to deep venture capital and startup data. You can search for companies by sector, pull detailed employee lists, map funding histories across multiple rounds, and track investor portfolios—all through natural conversation.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** venture-capital, startup-data, market-intelligence, funding-rounds, investor-research, company-metadata

## Description

Mattermark hooks your AI agent up directly to deep venture capital data and startup records. You don't just read a website; you run specialized queries against verified company history.

When you need to find startups, you can use **`search_companies`** to target companies based on criteria like their industry, where they're located, or when they were founded. For funding, you can search the global database of rounds using **`search_funding_rounds`**, specifying things like an amount range or a year.

Once you’ve got a company ID, you get a whole profile. **`get_company_details`** pulls the core metadata and general background info for that single company. You can map out its entire financial journey using **`get_company_funding_rounds`**, which gives you every investment round it's completed. If you need specifics on just one of those rounds, use **`get_funding_round_details`** to grab the exact date and dollar amount.

To see who works there right now, call **`get_company_employees`**. This tool retrieves current employee data and outlines the company's personnel structure. You can keep up with what’s happening in the news by running **`get_company_news`**, which pulls recent articles related to that specific ID.

Mapping out who the players are is just as important. To get a list of major venture capital firms and institutional money, you use **`list_investors`**. You can then drill down into any of those groups by using **`get_investor_details`**; this gives you their profile summary and background data. 

If you wanna know who's playing in the same sandbox, run **`list_similar_companies`** to find competitors or peers operating in a similar sector or market space. You can also verify that information by running **`get_company_details`** on any company ID you come across.

Your agent handles these complex lookups naturally. For example, if you ask it to track the funding history of Company X and then ask what kind of investors were involved in their Series B round, your AI client stitches together calls using **`get_company_funding_rounds`** for the full timeline, followed by a call to **`get_investor_details`** linked to that specific round's data. It’s all about running structured data requests through plain language conversation.

This server lets your agent build comprehensive profiles: finding startups via **`search_companies`**, pulling deep operational details using **`get_company_employees`**, tracking the money flow with **`get_funding_round_details`**, and understanding the network by listing investors with **`list_investors`**. You get verified data points, not vague summaries. It’s built for people who need precise answers about where the money is going.

## Tools

### get_company_details
Fetches the core metadata and general information for a single company ID.

### get_company_employees
Retrieves current employee data and personnel structure for a specific company.

### get_company_funding_rounds
Gets the full funding history, showing all investment rounds completed by a company.

### get_company_news
Pulls recent news articles and updates related to a specific company ID.

### get_funding_round_details
Retrieves precise details—like the amount and date—for one specific funding round.

### get_investor_details
Gets a profile summary and background information for an individual investor or fund.

### list_investors
Provides a list of known venture capital firms and institutional investors.

### list_similar_companies
Searches the database to find companies that operate in a similar sector or market space.

### search_companies
Performs targeted searches for companies based on criteria like industry, location, or founding date.

### search_funding_rounds
Searches the global database for funding rounds that match specific criteria (e.g., amount range, year).

## Prompt Examples

**Prompt:** 
```
Search for companies in the 'Fintech' sector in New York.
```

**Response:** 
```
Fetching companies... I found several fintech startups in New York, including 'Better.com' and 'Plaid'.
```

**Prompt:** 
```
Get funding history for company ID 123.
```

**Response:** 
```
Retrieving funding rounds... Company 123 has raised a total of $50M across 3 rounds (Seed, Series A, Series B).
```

**Prompt:** 
```
List similar companies to 'Stripe'.
```

**Response:** 
```
Searching for similar companies... I found 'Adyen', 'PayPal', and 'Square' as related entities.
```

## Capabilities

### Search for Companies
Find startups by criteria (like sector or location) using the `search_companies` tool.

### Analyze Company Profile
Get core details, employee counts, and recent news articles for a specific company via `get_company_details`, `get_company_employees`, and `get_company_news`.

### Track Funding History
Pull a full funding timeline using `get_company_funding_rounds` or get specifics on one round with `get_funding_round_details`.

### Map Investor Networks
List venture capital firms (`list_investors`) and inspect the portfolio details of specific investors using `get_investor_details`.

### Benchmark Competitors
Identify companies similar to a target firm or sector by calling `list_similar_companies`.

## Use Cases

### Conducting Due Diligence on a Target Company
You're vetting a potential acquisition. First, use `search_companies` to confirm the entity exists. Next, call `get_company_details` for basic metadata. Then, chain calls: run `get_company_funding_rounds` and follow up with `get_company_employees` to see if growth matches the capital raised. This gives you a full operational picture in minutes.

### Mapping an Investor's Focus
You want to know what VC firm 'Acme Capital' invests in. Start by calling `list_investors` and locating them. Then, use `get_investor_details` on their ID. Finally, run a search using `search_companies` filtered by the sectors Acme typically funds to build your market map.

### Analyzing Market Gaps
Your client wants to enter a new niche. Run `list_similar_companies` based on their current industry. This shows immediate competition. Then, use `search_funding_rounds` to see which specific investment amounts or stages are most common in that adjacent market.

### Tracking Employee Growth After a Round
A company just announced a Series B round. You need confirmation of hiring momentum. Use `get_company_funding_rounds` to confirm the date, then immediately call `get_company_employees` to see if headcount data aligns with the new capital infusion.

## Benefits

- Build a complete corporate profile faster. Instead of checking five different tabs, your agent can call `get_company_details`, `get_company_employees`, and `get_company_news` in one sequence to give you a full picture.
- Understand the money trail immediately. You don't have to piece together funding data; use `get_company_funding_rounds` to map every raise, then call `get_funding_round_details` for specific metrics like valuation and lead investor.
- Keep track of rivals without manual searches. If you need to benchmark a client, run `list_similar_companies` to instantly find related market players and see their general activity via `search_companies`.
- Map the money sources. Need to know who funded Company X? Run `list_investors` first to get a list of firms, then use `get_investor_details` on those names to understand their typical investment profile.
- Streamline due diligence. Instead of sifting through PDFs and press releases, you can query the system directly: 'What are the recent news items for this company?' using `get_company_news`.

## How It Works

The bottom line is that you treat complex database lookups like simple chat prompts, letting your agent handle all the multi-step API calling for you.

1. Subscribe to the Mattermark server and enter your personal API Key.
2. Your AI client (Claude, Cursor, etc.) sends a natural language query to the MCP endpoint.
3. The agent translates the intent into one or more specific tool calls (e.g., `search_companies` then `get_company_details`), gathers the data, and returns the final answer.

## Frequently Asked Questions

**Can Mattermark MCP Server find employees not listed in get_company_employees?**
No, it can only retrieve data that exists within the platform's database. If employee records aren't available, calling `get_company_employees` won't return them.

**How do I find a competitor using list_similar_companies?**
Just provide the name of a company or sector you want to benchmark against. The tool will return related entities, which you can then investigate further with `get_company_details`.

**What data does get_funding_round_details give me?**
It provides granular details about one specific round—things like the exact amount raised, the date of the investment, and sometimes the lead investor. You need a funding ID to use this tool.

**Is Mattermark MCP Server only for US companies?**
The database supports searching globally, but specific data coverage depends on what Mattermark has indexed. Use `search_companies` with location filters to narrow your focus.

**How do I authenticate my API key when running a tool like `get_company_details`?**
The server handles your credentials securely through the MCP connection. You pass your Mattermark API Key during setup, and your AI agent uses it to authorize all subsequent tool calls automatically.

**What are the rate limits if I run many searches using `search_companies`?**
The service adheres to standard API rate limiting practices. If you exceed the limit, the tool will return an HTTP 429 error code. Your agent should be configured to catch this and implement a backoff/retry sequence.

**Can I filter employee data from `get_company_employees` by specific parameters?**
Yes, you can refine the list of employees using filters. When calling the tool, include optional parameters like `job_title`, `department`, or a date range to narrow down results.

**What happens if I provide an invalid ID when running `get_company_news`?**
If you use an incorrect company identifier, the tool returns a specific 'Resource Not Found' message. Your agent can then prompt you to validate the input or try searching for the company name instead.

**How do I find my Mattermark API Key?**
Log in to Mattermark and go to your Account Settings to find and copy your API Key.

**What kind of company data can I access?**
You can access company metadata, funding rounds, news, employee counts, and location info.

**Is my API Key secure?**
Yes. Your token is encrypted at rest and injected securely at runtime.