# M&A Intelligence MCP server

Source: https://developers.novilabs.com/ma/mcp/

> Let an AI assistant search, summarize, chart and tabulate upstream M&A deals, with 10 tools that act as you.

Ask an assistant such as Claude to find, total, chart and tabulate upstream M&A deals, and keep a comps basket, as you.

## Connect

| | |
| --- | --- |
| URL | `https://<your-company>.novilabs.io/intelligence-ma/api/mcp`, on the host you use for Novi apps in the browser |
| Transport | Streamable HTTP |
| Sign-in | Novi sign-in from a supported client, or a Novi API token as `Authorization: Bearer` |
| Permissions | **Access Intelligence M&A**. Signing in from an assistant also needs **Access MCP** |
| Status | [Preview] Charts and tables (`ma_chart_deals`, `ma_table_deals`) are not yet on company hosts |

  **Novi sign-in**
Add the URL as a custom connector or remote MCP server and sign in with your Novi login. Supported clients and steps: [Connect an assistant](https://developers.novilabs.com/ai/connect/).
  
  **Novi API token**
Any client that takes a URL and a header works, with a [token](https://developers.novilabs.com/start/authentication/#novi-api-token) for a user with Access Intelligence M&A.

```bash title="Claude Code"
claude mcp add --transport http novi-ma https://<your-company>.novilabs.io/intelligence-ma/api/mcp \
  --header "Authorization: Bearer $NOVI_API_TOKEN"
```

If the token expires or is revoked, create a new one and update the client.
  

## Tools

| Tool | What it does | Key inputs |
| --- | --- | --- |
| `ma_search_deals` | Turns a sentence into filters and runs them. Returns the filters, its `interpretation`, and `unsupported` and `unknown_companies` for the parts of the question the data can't express | `query`, `limit`, `offset` |
| `ma_filter_deals` | Lists deals that match explicit filters. Returns `total`, `limit`, `offset` and `transactions` | [Filters](#filters), `sort`, `dir`, `limit`, `offset` |
| `ma_summarize_deals` | Totals, averages and medians over the matching deals in one call, with breakdowns by deal type, scope, commodity, consideration type and ownership direction | [Filters](#filters) |
| `ma_filter_values` | Valid filter values as spelled in the data, basin to sub-basin pairings and sort keys. No company names | None |
| `ma_get_deal` | Full detail for one deal: every column plus basins, states, tags, advisors and the analyst's comments | `deal_id` |
| `ma_basket_add` | Adds deals to your comps basket. Returns the basket's deal ids, how many were added and `unknown_ids` | `deal_ids` |
| `ma_basket_remove` | Removes deals from your basket. Returns the basket's deal ids, how many were removed and `not_in_basket` | `deal_ids` |
| `ma_basket_list` | Your basket in full, oldest first, with the detail `ma_get_deal` returns. Returns `count` and `transactions` | None |
| `ma_chart_deals` | Charts deals: one bar or point per value of `dim`, measuring `metric` | `dim`, `metric`, `type`, `color_by`, `secondary_metric`, `top`, [filters](#filters) |
| `ma_table_deals` | Shows matching deals as a table: announced, buyer, seller, type, basins, value, production and price per flowing BOE/d | `sort`, `dir`, `limit`, `offset`, [filters](#filters) |

Use `ma_search_deals` in conversation, `ma_filter_deals` when the filters are decided, and `ma_summarize_deals` for "how much".

## Filters

`ma_filter_deals`, `ma_summarize_deals`, `ma_chart_deals` and `ma_table_deals` take these filters. Values in one list are ORed; different filters are ANDed.

| Filter | Takes |
| --- | --- |
| `search` | Full text over the deal |
| `basin`, `subbasin` | Lists of names |
| `state`, `buyer`, `seller`, `deal_type`, `deal_scope`, `commodity`, `deal_tag`, `other_asset_tag`, `consideration_type`, `ownership_dir` | Lists of values as `ma_filter_values` spells them. Buyer and seller names are used as given |
| `year_min`, `year_max` | Announcement years |
| `announce_from`, `announce_to`, `close_from`, `close_to` | Dates as `YYYY-MM-DD`, inclusive. A closing range matches only deals that have closed |
| `size_min`, `size_max` | Total consideration in $MM |
| `production_min`, `production_max` | Net production in Mboe/d, so 500 boe/d is 0.5. Matches only deals that disclose production |
| `liquids_min`, `liquids_max` | Liquids share of production in percent, 0 to 100 |

- Midland, Delaware, Marcellus and Utica are sub-basins. Given as a basin, they match as sub-basins and the result says so. An unknown name is an error that lists the valid names.
- The deal tag `Novi Research` selects deals Novi has published research on.
- Liquids filters take a percent; the `LIQUIDS` column in [Snowflake](https://developers.novilabs.com/ma/data/) is a fraction from 0 to 1.

## Totals and coverage

Each total says how many deals it covers, since not every deal discloses every figure.

| Figure | Covers |
| --- | --- |
| `total_count` | Every matching deal |
| `total_value`, `avg_value`, `median_value` ($MM) | `valued_count`, the deals that disclose a price |
| `total_production` (Mboe/d) | `production_count` |
| `median_consideration_per_boe` ($ per BOE/d) | `consideration_per_boe_count` |

Quote the count with the figure, for example "$4,800MM across 12 of 15 deals".

## Charts and tables

In clients that support MCP Apps, such as Claude, `ma_chart_deals` draws a chart with a table tab and `ma_table_deals` a sortable table. Every client gets the rows as JSON.

| Setting | Values |
| --- | --- |
| `dim` (the axis) | `year`, `close_year`, `deal_size`, `deal_type`, `deal_scope`, `commodity`, `ownership`, `consideration`, `buyer`, `seller`, `pe`, `basin`, `subbasin`, `geography`, `deal_tags`, `pe_firm`, `sponsor_type` |
| `metric` | `count` (default), `value`, `avg`, `production`, `acres`, `pv10`, `per_boe`, `consideration_per_boe` |
| `type` | `bar` (default), `line` for a trend over years, `table` to open on the table |
| `top` | How many of the largest to show on an unordered axis such as buyer or basin: 1 to 50, default 20. Years and deal-size bands show in full |
| `color_by` | Splits each bar into stacked bands by a second dimension. Not with an averaged metric (`avg`, `per_boe`, `consideration_per_boe`) |
| `secondary_metric` | A second measure drawn as a labelled line on a right-hand axis |

On `basin`, `subbasin`, `geography`, `deal_tags`, `pe_firm` and `sponsor_type`, a deal counts under each of its values, so bars can add up to more than the matching deals. The result's `notes` say so, and when a figure covers only the deals that disclose it.

## Paging, basket and errors

- **Paging.** `limit` is 1 to 100 rows, default 25. Page with `offset`.
- **Comps basket.** One per person, kept across sessions, up to 50 deals. Separate from the comps list in the M&A app.
- **Deal ids.** `deal_id` is not the `MA_DEAL_KEY` in Snowflake.
- **Errors.** An unknown deal id or filter value comes back as a tool result that names the cause.
- **Search limits.** `ma_search_deals` is rate limited per person; the error says how many seconds to wait. `ma_filter_deals` is not affected.

## What Novi records

For each tool call, Novi records the tool name, how long it took, whether it failed, how many deals it returned, which filters had a value, and the assistant app you signed in from. Filter values and the text of your search are not recorded.

## Good prompts

- Chart deal count by year since 2015, split by deal size, with total value as a line.
- Show the 15 largest Permian deals since 2020 as a table.
- Chart the top 10 buyers in the Permian since 2020 by total value.
- How much was paid for oil-weighted Williston deals closed since 2023, and how many of them disclosed a price?

> **Note:**
> Ask follow-ups in the same chat. Add deals to your basket as you go, then list the basket to compare them.
