---
type: "firecrawl-provider"
description: "Company, consumer and location data from Carbon Arc, called with Firecrawl's Carbon Arc account."
use_when: "Entity, insight, ontology, dataset, and filter lookups.\n\nFind events and the entities or insights linked to them."
categories: "Company"
capabilities: 9
credits_per_call: 0
---
# Carbon Arc on Firecrawl Alexandria

Company, consumer and location data from Carbon Arc, called with Firecrawl's Carbon Arc account.

- Categories: Company
- Category index: [Company category](https://alexandria.firecrawl.dev/agents/categories/company)
- Provider key: `carbon-arc`
- Access: Firecrawl credits
- Cost: 0 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/carbon-arc)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/openapi.json)

## Capabilities

- [search_entities](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/search_entities): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [search_insights](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/search_insights): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [get_insights_from_entity](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/get_insights_from_entity): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [data_library](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/data_library): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [ontology](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/ontology): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [search_events](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/search_events): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [get_insights_from_event](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_insights_from_event): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [get_entities_from_event](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_entities_from_event): The MCP tool result: content blocks, and structuredContent when the server sends it.
- [get_events_from_entity](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_events_from_entity): The MCP tool result: content blocks, and structuredContent when the server sends it.

## 1. Choose this provider when

Entity, insight, ontology, dataset, and filter lookups.

Find events and the entities or insights linked to them.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "carbon-arc",
  "capability": "discovery/search_entities",
  "options": {
    "query": "<query>",
    "limit": 10
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `query` (string, required): Search for entities by name or description Example: `<query>`
- `entity_representations` (string[]): Optional filter: one representation or a list (OR semantics). Only pass when highly confident the value(s) are valid — typically copied from search_entities response or other metadata exposed to the user from other tools. Valid values: 'abundle' (App Bundle), 'actor' (Actor), 'aingredient' (Active Ingredient), 'app' (App), 'apublisher' (App Publisher), 'artist' (Artist), 'bullbearargument' (BullBearArgument), 'category' (Category), 'cbsa' (CBSA), 'city' (City), 'clfiling' (CLFiling), 'clopinion' (CLOpinion), 'comcategory' (Commodity Category), 'company' (Company), 'country' (Country), 'court' (Court), 'dccategory' (Document Content Category), 'ddcategory' (Document Domain Category), 'director' (Director), 'distributor' (Music Distributor), 'dma' (DMA), 'docket' (Docket), 'dtcategory' (Document Type Category), 'educationlevel' (Education Level), 'entertainer' (Entertainer), 'ethnicity' (Ethnicity), 'finished' (Finished Commodity), 'franchise' (Franchise), 'gender' (Gender), 'generation' (Generation), 'genre' (Genre), 'judge' (Judge), 'label' (Music Label), 'lawyer' (Lawyer), 'league' (League), 'legalmatter' (Legal Matter), 'maritalstatus' (Marital Status), 'medicalsegment' (Medical Segment), 'mine' (Mine), 'newsarticle' (NewsArticle), 'occupation' (Occupation), 'pcodecategory' (Procedure Code Category), 'plabel' (Private Label Brand), 'platform' (Platform), 'port' (Port), 'product' (Product Brand), 'quailinvoice' (QuailInvoice), 'quailmatter' (QuailMatter), 'raw' (Raw Commodity), 'region' (Region), 'retailer' (Retailer Banner Brand), 'secfiling10k' (SecFiling10K), 'secfiling10q' (SecFiling10Q), 'service' (Service Brand), 'socialhandle' (Social Handle), 'song' (Song), 'sport' (Sport), 'state' (State), 'team' (Team), 'ticker' (Ticker), 'title' (Title), 'transcript' (Transcript), 'transformed' (Transformed Commodity), 'us' (US), 'vehiclebody' (Vehicle Body Style), 'vehiclemake' (Vehicle Make Brand), 'vehiclemodel' (Vehicle Model Brand), 'venue' (Venue), 'website' (Website), 'ww' (Worldwide), 'yearlyincome' (Income), 'zip' (Zip Code) Example: `[]`
- `limit` (number): Maximum number of entities to return Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "carbon-arc",
    capability: "discovery/search_entities",
    options: {
      query: "<query>",
      limit: 10,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "carbon-arc",
  "capability": "discovery/search_entities",
  "options": {
    "query": "<query>",
    "limit": 10
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "carbon-arc",
    "capability": "discovery/search_entities",
    "options": {
      "query": "<query>",
      "limit": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'carbon-arc/discovery/search_entities' \
  --options '{"query":"<query>","limit":10}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "carbon-arc",
  "capability": "discovery/search_entities",
  "options": {
    "query": "<query>",
    "limit": 10
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "carbon-arc",
  "capability": "discovery/search_entities",
  "options": {
    "query": "<query>",
    "limit": 10
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### search_entities

- Capability: `discovery/search_entities`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Search for entities by name or description.

Optionally filter by entity_representations (single string or list) to narrow
results to specific entity types. See the entity_representations parameter
for valid values.

Valid entity_representation values: abundle, actor, aingredient, app, apublisher, artist, bullbearargument, category, cbsa, city, clfiling, clopinion, comcategory, company, country, court, dccategory, ddcategory, director, distributor, dma, docket, dtcategory, educationlevel, entertainer, ethnicity, finished, franchise, gender, generation, genre, judge, label, lawyer, league, legalmatter, maritalstatus, medicalsegment, mine, newsarticle, occupation, pcodecategory, plabel, platform, port, product, quailinvoice, quailmatter, raw, region, retailer, secfiling10k, secfiling10q, service, socialhandle, song, sport, state, team, ticker, title, transcript, transformed, us, vehiclebody, vehiclemake, vehiclemodel, venue, website, ww, yearlyincome, zip
- Cost: 0 credits per call
- Capability file: [search_entities](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/search_entities)

Accepted options:
- `query` (string, required): Search for entities by name or description Example: `<query>`
- `entity_representations` (string[]): Optional filter: one representation or a list (OR semantics). Only pass when highly confident the value(s) are valid — typically copied from search_entities response or other metadata exposed to the user from other tools. Valid values: 'abundle' (App Bundle), 'actor' (Actor), 'aingredient' (Active Ingredient), 'app' (App), 'apublisher' (App Publisher), 'artist' (Artist), 'bullbearargument' (BullBearArgument), 'category' (Category), 'cbsa' (CBSA), 'city' (City), 'clfiling' (CLFiling), 'clopinion' (CLOpinion), 'comcategory' (Commodity Category), 'company' (Company), 'country' (Country), 'court' (Court), 'dccategory' (Document Content Category), 'ddcategory' (Document Domain Category), 'director' (Director), 'distributor' (Music Distributor), 'dma' (DMA), 'docket' (Docket), 'dtcategory' (Document Type Category), 'educationlevel' (Education Level), 'entertainer' (Entertainer), 'ethnicity' (Ethnicity), 'finished' (Finished Commodity), 'franchise' (Franchise), 'gender' (Gender), 'generation' (Generation), 'genre' (Genre), 'judge' (Judge), 'label' (Music Label), 'lawyer' (Lawyer), 'league' (League), 'legalmatter' (Legal Matter), 'maritalstatus' (Marital Status), 'medicalsegment' (Medical Segment), 'mine' (Mine), 'newsarticle' (NewsArticle), 'occupation' (Occupation), 'pcodecategory' (Procedure Code Category), 'plabel' (Private Label Brand), 'platform' (Platform), 'port' (Port), 'product' (Product Brand), 'quailinvoice' (QuailInvoice), 'quailmatter' (QuailMatter), 'raw' (Raw Commodity), 'region' (Region), 'retailer' (Retailer Banner Brand), 'secfiling10k' (SecFiling10K), 'secfiling10q' (SecFiling10Q), 'service' (Service Brand), 'socialhandle' (Social Handle), 'song' (Song), 'sport' (Sport), 'state' (State), 'team' (Team), 'ticker' (Ticker), 'title' (Title), 'transcript' (Transcript), 'transformed' (Transformed Commodity), 'us' (US), 'vehiclebody' (Vehicle Body Style), 'vehiclemake' (Vehicle Make Brand), 'vehiclemodel' (Vehicle Model Brand), 'venue' (Venue), 'website' (Website), 'ww' (Worldwide), 'yearlyincome' (Income), 'zip' (Zip Code) Example: `[]`
- `limit` (number): Maximum number of entities to return Example: `10`

Response schema example:
```json
{}
```

### search_insights

- Capability: `discovery/search_insights`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Search for insights by name or description.
- Cost: 0 credits per call
- Capability file: [search_insights](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/search_insights)

Accepted options:
- `query` (string, required): Search for insights by name or description Example: `<query>`
- `limit` (number): Maximum number of insights to return Example: `10`

Response schema example:
```json
{}
```

### get_insights_from_entity

- Capability: `discovery/get_insights_from_entity`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Get insights related to a specific entity.

Retrieves insights associated with a particular entity (e.g., company,
state, retailer). Useful for exploring what data is available for a
specific entity or understanding entity-insight relationships.

Valid entity_representation values: abundle, actor, aingredient, app, apublisher, artist, bullbearargument, category, cbsa, city, clfiling, clopinion, comcategory, company, country, court, dccategory, ddcategory, director, distributor, dma, docket, dtcategory, educationlevel, entertainer, ethnicity, finished, franchise, gender, generation, genre, judge, label, lawyer, league, legalmatter, maritalstatus, medicalsegment, mine, newsarticle, occupation, pcodecategory, plabel, platform, port, product, quailinvoice, quailmatter, raw, region, retailer, secfiling10k, secfiling10q, service, socialhandle, song, sport, state, team, ticker, title, transcript, transformed, us, vehiclebody, vehiclemake, vehiclemodel, venue, website, ww, yearlyincome, zip
- Cost: 0 credits per call
- Capability file: [get_insights_from_entity](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/get_insights_from_entity)

Accepted options:
- `entity_id` (number, required): Unique identifier for the entity you want to analyze Example: `10`
- `entity_representation` (string, required): Entity type/category to filter insights. Valid values: 'abundle' (App Bundle), 'actor' (Actor), 'aingredient' (Active Ingredient), 'app' (App), 'apublisher' (App Publisher), 'artist' (Artist), 'bullbearargument' (BullBearArgument), 'category' (Category), 'cbsa' (CBSA), 'city' (City), 'clfiling' (CLFiling), 'clopinion' (CLOpinion), 'comcategory' (Commodity Category), 'company' (Company), 'country' (Country), 'court' (Court), 'dccategory' (Document Content Category), 'ddcategory' (Document Domain Category), 'director' (Director), 'distributor' (Music Distributor), 'dma' (DMA), 'docket' (Docket), 'dtcategory' (Document Type Category), 'educationlevel' (Education Level), 'entertainer' (Entertainer), 'ethnicity' (Ethnicity), 'finished' (Finished Commodity), 'franchise' (Franchise), 'gender' (Gender), 'generation' (Generation), 'genre' (Genre), 'judge' (Judge), 'label' (Music Label), 'lawyer' (Lawyer), 'league' (League), 'legalmatter' (Legal Matter), 'maritalstatus' (Marital Status), 'medicalsegment' (Medical Segment), 'mine' (Mine), 'newsarticle' (NewsArticle), 'occupation' (Occupation), 'pcodecategory' (Procedure Code Category), 'plabel' (Private Label Brand), 'platform' (Platform), 'port' (Port), 'product' (Product Brand), 'quailinvoice' (QuailInvoice), 'quailmatter' (QuailMatter), 'raw' (Raw Commodity), 'region' (Region), 'retailer' (Retailer Banner Brand), 'secfiling10k' (SecFiling10K), 'secfiling10q' (SecFiling10Q), 'service' (Service Brand), 'socialhandle' (Social Handle), 'song' (Song), 'sport' (Sport), 'state' (State), 'team' (Team), 'ticker' (Ticker), 'title' (Title), 'transcript' (Transcript), 'transformed' (Transformed Commodity), 'us' (US), 'vehiclebody' (Vehicle Body Style), 'vehiclemake' (Vehicle Make Brand), 'vehiclemodel' (Vehicle Model Brand), 'venue' (Venue), 'website' (Website), 'ww' (Worldwide), 'yearlyincome' (Income), 'zip' (Zip Code) Example: `<entity_representation>`
- `limit` (number): Maximum number of insights to return Example: `100`

Response schema example:
```json
{}
```

### data_library

- Capability: `discovery/data_library`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Search and describe datasets in the CarbonArc data library.

Use this tool for dataset discovery and provenance questions:
- "What data do you have about card spend?"
- "Where does this data come from?"
- "What fields are available in the retail foot traffic dataset?"

**Routing:**
- Any ID provided (insight_id, topic_id, dataset_id) → describe mode: returns the full
  TearSheet for that dataset, including provider, frequency, history, delivery method,
  panel size, coverage, bias, lag, geographic availability, data dictionary,
  raw `tearsheet_data` metadata, and last refresh date.
- Only query provided → search mode: semantic search over datasets by name/description.
- No arguments → catalog overview: returns the full accessible TearSheet catalog
  (subject to source access restrictions).

**Search then describe:**
Call with a query first to find relevant datasets, then pass the `tearsheet_name`
from any search result as `dataset_id` to retrieve its full TearSheet details.

**This tool vs search_insights:**
- Use `data_library` for dataset/provenance questions (what data exists, what fields,
  where does it come from, how is it collected).
- Use `search_insights` for metric discovery (finding specific analytical insights/KPIs
  to use in framework queries).
- Cost: 0 credits per call
- Capability file: [data_library](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/data_library)

Accepted options:
- `query` (string): Free-text search query to find matching datasets. Omit to return the full catalog overview. Example: `<query>`
- `insight_id` (number): insight_id from search_insights results — returns full dataset provenance for that insight. Example: `10`
- `topic_id` (number): topic_id from search_insights results — returns full dataset provenance for that topic. Example: `10`
- `dataset_id` (string): Pass the tearsheet_name from a data_library search result here to get full provenance for that dataset. Example: `<dataset_id>`

Response schema example:
```json
{}
```

### ontology

- Capability: `discovery/ontology`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Explore Carbon Arc's ontology — the read-only internal knowledge graph linking
companies, brands, categories, locations, apps, websites, subjects, topics,
insights, and datasets.

Ask natural-language questions about how entities relate, what data covers what,
and overall graph structure. Returns relationship tables — not metrics, trends,
or time-series values.

**Question shapes:**
- **Anchored** — about specific named things (e.g. "What brands does Walmart own?",
  "What topics does Target have?"). Names are resolved to graph IDs automatically.
- **Entity-free** — global counts, listings, or schema (e.g. "How many companies
  do we cover?", "What relationship types are in the graph?"). No entity_ids needed.

**Input:**
- ``question`` only (default) — routing infers which entities the question refers to.
- ``entity_ids`` — skip name resolution on retry after checking
  ``metadata.entity_resolution_metadata`` or calling a discovery tool below.

**Example questions:**
- Categories & locations: "What sub-categories does beverages have?",
  "What sector is Walmart in?", "What cities are in California?"
- Ownership & brands: "What brands does Pepsi own?", "Who owns Dunkin?",
  "What private labels does Costco carry?"
- Apps & websites: "What apps does Nike have?", "What websites does Walmart have?"
- Subjects & topics: "What KPI topics does Target have?",
  "What topics do Walmart and Costco share?", "What subjects are covered for Walmart?"
- Data coverage: "What tearsheets cover Walmart?", "What insights do you have for Walmart?"
- Graph-wide: "What subjects are in the graph?", "How many companies do we cover?",
  "What relationship types are in the graph?"

**Not for (use another tool):**
- Business metrics or trends → text_to_insight or synthesize_answer
- Analyzing named-event relationships with other graph nodes (entities,
  insights) — not supported yet. Use search_events / get_events_from_* /
  get_insights_from_event / get_entities_from_event. Graph hits about
  "metric events" or EventSubject topics are insight/topic coverage, not
  those event↔entity/insight relationship queries.
- Dataset provenance or catalog → data_library (including data asset IDs like CA0056, BulkAPI, BlockData)
- Platform documentation → search_docs
- Finding entities by name → search_entities
- Searching insights by keyword → search_insights

**Wrong-tool examples:**
- "What was Walmart's revenue last quarter?" → text_to_insight
- "Which companies are linked to Apple Q3 earnings?" → search_events / get_entities_from_event
- "Where does foot traffic data come from?" → data_library
- "Find companies named Acme" → search_entities
- Cost: 0 credits per call
- Capability file: [ontology](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/discovery/ontology)

Accepted options:
- `question` (string, required): Natural-language question about Carbon Arc's ontology (internal knowledge graph): how entities relate, what data covers what, and graph structure. Examples: 'What sub-categories does beverages category have?', 'What sector is Walmart in?', 'What cities are in California?', 'What brands does Walmart own?', 'What apps does Target have?', 'What topics does Nike have?', 'What tearsheets cover Walmart?', 'What topics do Walmart and Costco share?', 'How many companies do we cover?' Example: `<question>`
- `entity_ids` (object[]): Optional retry with pinned resolution. Pass entity_id and entity_representation from search_entities (companies, brands, …), search_insights (insights), or entity_resolution_metadata on a prior ontology response — never guess IDs. Example: `[]`
- `reranker` (string): Optional override for entity resolution reranker (default from service config). Example: `cross_encoder`

Response schema example:
```json
{}
```

### search_events

- Capability: `events/search_events`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Search for events by name or description.

The entry point for event discovery: resolves an event name to its
event_id, event_type, and event_category_id. Feed those into the
get_insights_from_event / get_entities_from_event tools or into
build_framework to analyze the event. Optionally narrow by event_type.
- Cost: 0 credits per call
- Capability file: [search_events](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/search_events)

Accepted options:
- `query` (string, required): Search for events by name or description Example: `<query>`
- `event_type` (string): Filter results to a specific event type (flow). Valid values: 'Calendar Events', 'Corporate Events', 'Entity Events', 'Industry Events', 'Macro Event' Example: `<event_type>`
- `limit` (number): Maximum number of events to return Example: `10`

Response schema example:
```json
{}
```

### get_insights_from_event

- Capability: `events/get_insights_from_event`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Get insights linked to a specific event.

Retrieves insights associated with a particular event node. Useful for
exploring what data is available for a specific event or understanding
event-insight relationships. Use search_events first to resolve an event
name to its event_id and event_type.
- Cost: 0 credits per call
- Capability file: [get_insights_from_event](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_insights_from_event)

Accepted options:
- `event_id` (number, required): Unique identifier (carc_id) for the event Example: `10`
- `event_type` (string, required): Type of the event. Valid values: 'Calendar Events', 'Corporate Events', 'Entity Events', 'Industry Events', 'Macro Event' Example: `<event_type>`
- `limit` (number): Maximum number of insights to return Example: `10`

Response schema example:
```json
{}
```

### get_entities_from_event

- Capability: `events/get_entities_from_event`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Get entities linked to a specific event.

Retrieves entities associated with a particular parent event (e.g. companies
for a corporate filing). Use search_events first to resolve an event name
to its event_id and event_type.
- Cost: 0 credits per call
- Capability file: [get_entities_from_event](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_entities_from_event)

Accepted options:
- `event_id` (number, required): Unique identifier (carc_id) for the event Example: `10`
- `event_type` (string, required): Type of the event. Valid values: 'Calendar Events', 'Corporate Events', 'Entity Events', 'Industry Events', 'Macro Event' Example: `<event_type>`
- `entity_representation` (string, required): Entity type/category to filter entities linked to the event. Valid values: 'abundle' (App Bundle), 'actor' (Actor), 'aingredient' (Active Ingredient), 'app' (App), 'apublisher' (App Publisher), 'artist' (Artist), 'bullbearargument' (BullBearArgument), 'category' (Category), 'cbsa' (CBSA), 'city' (City), 'clfiling' (CLFiling), 'clopinion' (CLOpinion), 'comcategory' (Commodity Category), 'company' (Company), 'country' (Country), 'court' (Court), 'dccategory' (Document Content Category), 'ddcategory' (Document Domain Category), 'director' (Director), 'distributor' (Music Distributor), 'dma' (DMA), 'docket' (Docket), 'dtcategory' (Document Type Category), 'educationlevel' (Education Level), 'entertainer' (Entertainer), 'ethnicity' (Ethnicity), 'finished' (Finished Commodity), 'franchise' (Franchise), 'gender' (Gender), 'generation' (Generation), 'genre' (Genre), 'judge' (Judge), 'label' (Music Label), 'lawyer' (Lawyer), 'league' (League), 'legalmatter' (Legal Matter), 'maritalstatus' (Marital Status), 'medicalsegment' (Medical Segment), 'mine' (Mine), 'newsarticle' (NewsArticle), 'occupation' (Occupation), 'pcodecategory' (Procedure Code Category), 'plabel' (Private Label Brand), 'platform' (Platform), 'port' (Port), 'product' (Product Brand), 'quailinvoice' (QuailInvoice), 'quailmatter' (QuailMatter), 'raw' (Raw Commodity), 'region' (Region), 'retailer' (Retailer Banner Brand), 'secfiling10k' (SecFiling10K), 'secfiling10q' (SecFiling10Q), 'service' (Service Brand), 'socialhandle' (Social Handle), 'song' (Song), 'sport' (Sport), 'state' (State), 'team' (Team), 'ticker' (Ticker), 'title' (Title), 'transcript' (Transcript), 'transformed' (Transformed Commodity), 'us' (US), 'vehiclebody' (Vehicle Body Style), 'vehiclemake' (Vehicle Make Brand), 'vehiclemodel' (Vehicle Model Brand), 'venue' (Venue), 'website' (Website), 'ww' (Worldwide), 'yearlyincome' (Income), 'zip' (Zip Code) Example: `<entity_representation>`
- `limit` (number): Maximum number of entities to return Example: `10`

Response schema example:
```json
{}
```

### get_events_from_entity

- Capability: `events/get_events_from_entity`
- Description: The MCP tool result: content blocks, and structuredContent when the server sends it.
- Instructions: Get events linked to a specific entity.

Retrieves events associated with a particular entity through shared insights.
Useful for discovering which events are connected to a given company or entity.
Use search_entities first to resolve an entity name to its entity_id.
- Cost: 0 credits per call
- Capability file: [get_events_from_entity](https://alexandria.firecrawl.dev/agents/providers/carbon-arc/events/get_events_from_entity)

Accepted options:
- `entity_id` (number, required): Unique identifier (carc_id) for the entity Example: `10`
- `entity_representation` (string, required): Entity type/category for the entity. Valid values: 'abundle' (App Bundle), 'actor' (Actor), 'aingredient' (Active Ingredient), 'app' (App), 'apublisher' (App Publisher), 'artist' (Artist), 'bullbearargument' (BullBearArgument), 'category' (Category), 'cbsa' (CBSA), 'city' (City), 'clfiling' (CLFiling), 'clopinion' (CLOpinion), 'comcategory' (Commodity Category), 'company' (Company), 'country' (Country), 'court' (Court), 'dccategory' (Document Content Category), 'ddcategory' (Document Domain Category), 'director' (Director), 'distributor' (Music Distributor), 'dma' (DMA), 'docket' (Docket), 'dtcategory' (Document Type Category), 'educationlevel' (Education Level), 'entertainer' (Entertainer), 'ethnicity' (Ethnicity), 'finished' (Finished Commodity), 'franchise' (Franchise), 'gender' (Gender), 'generation' (Generation), 'genre' (Genre), 'judge' (Judge), 'label' (Music Label), 'lawyer' (Lawyer), 'league' (League), 'legalmatter' (Legal Matter), 'maritalstatus' (Marital Status), 'medicalsegment' (Medical Segment), 'mine' (Mine), 'newsarticle' (NewsArticle), 'occupation' (Occupation), 'pcodecategory' (Procedure Code Category), 'plabel' (Private Label Brand), 'platform' (Platform), 'port' (Port), 'product' (Product Brand), 'quailinvoice' (QuailInvoice), 'quailmatter' (QuailMatter), 'raw' (Raw Commodity), 'region' (Region), 'retailer' (Retailer Banner Brand), 'secfiling10k' (SecFiling10K), 'secfiling10q' (SecFiling10Q), 'service' (Service Brand), 'socialhandle' (Social Handle), 'song' (Song), 'sport' (Sport), 'state' (State), 'team' (Team), 'ticker' (Ticker), 'title' (Title), 'transcript' (Transcript), 'transformed' (Transformed Commodity), 'us' (US), 'vehiclebody' (Vehicle Body Style), 'vehiclemake' (Vehicle Make Brand), 'vehiclemodel' (Vehicle Model Brand), 'venue' (Venue), 'website' (Website), 'ww' (Worldwide), 'yearlyincome' (Income), 'zip' (Zip Code) Example: `<entity_representation>`
- `limit` (number): Maximum number of events to return Example: `10`
- `event_type` (string): Filter results to a specific event type. Valid values: 'Calendar Events', 'Corporate Events', 'Entity Events', 'Industry Events', 'Macro Event' Example: `<event_type>`

Response schema example:
```json
{}
```
