# datasets_sec_companies_facets

Facet the SEC companies dataset. Returns terms-aggregation counts for one facet of the SEC companies dataset, scoped to the same filters as search. Facet enum: sic, sic_description, exchange, state_of_incorporation, entity_type, reporting_currency, revenue_band, forms_filed. revenue_band buckets latest-annual revenue into: unknown, under_1m, 1m_10m, 10m_100m, 100m_1b, 1b_10b, over_10b.

Agent View of the PolicyLayer registry record for `datasets_sec_companies_facets`. HTML page: https://policylayer.com/tools/crawlora-mcp/datasets-sec-companies-facets

## Facts

- Tool: `datasets_sec_companies_facets`
- Server: Crawlora (`crawlora-mcp`) — https://policylayer.com/tools/crawlora-mcp.md
- Install: `npx -y crawlora-mcp`
- Homepage: https://www.npmjs.com/package/crawlora-mcp
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 11 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | no | Full-text query over the company name, or an exact ticker match, max 256 characters |
| `sic` | string | no | Exact SIC industry-code filter, max 32 characters |
| `facet` | string | yes | Facet enum: sic, sic_description, exchange, state_of_incorporation, entity_type, reporting_currency, revenue_band, forms_filed |
| `ticker` | string | no | Exact ticker filter (case-insensitive), max 32 characters |
| `exchange` | string | no | Exact exchange filter as reported by EDGAR, max 64 characters |
| `form_filed` | string | no | Exact form-type filter, e.g. 10-K, 8-K |
| `entity_type` | string | no | Exact entity-type filter, max 64 characters |
| `min_revenue` | number | no | Minimum latest-annual revenue in USD (normalized at reference rates), 0 or greater |
| `has_financials` | boolean | no | When true, keep only companies that have XBRL financial statements |
| `reporting_currency` | string | no | Exact reporting-currency filter, ISO-4217 code, e.g. USD, JPY, EUR |
| `state_of_incorporation` | string | no | Exact state/country-of-incorporation filter, max 32 characters |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "datasets_sec_companies_facets",
    "arguments": {
      "facet": "<facet>"
    }
  }
}
```

## Why datasets_sec_companies_facets is rated Low

Even though datasets_sec_companies_facets only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

Risk signals: High parameter count (11 properties)

## Use case

AI agents call datasets_sec_companies_facets to retrieve information from Crawlora without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Crawlora:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "datasets_sec_companies_facets": {}
  }
}
```

## Other tools on Crawlora (727)

- `anime_title` — Execute — https://policylayer.com/tools/crawlora-mcp/anime-title.md
- `coingecko_new_coins` — Execute — https://policylayer.com/tools/crawlora-mcp/coingecko-new-coins.md
- `justwatch_discover` — Execute — https://policylayer.com/tools/crawlora-mcp/justwatch-discover.md
- `justwatch_new` — Execute — https://policylayer.com/tools/crawlora-mcp/justwatch-new.md
- `manga_title` — Execute — https://policylayer.com/tools/crawlora-mcp/manga-title.md
- `steam_charts_top_releases` — Execute — https://policylayer.com/tools/crawlora-mcp/steam-charts-top-releases.md
- `yahoo_finance_ticker_history` — Execute — https://policylayer.com/tools/crawlora-mcp/yahoo-finance-ticker-history.md
- `airbnb_host` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-host.md
- `airbnb_host_listings` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-host-listings.md
- `airbnb_host_reviews` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-host-reviews.md
- `airbnb_room` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-room.md
- `airbnb_room_calendar` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-room-calendar.md
- `airbnb_room_reviews` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-room-reviews.md
- `airbnb_search` — Read — https://policylayer.com/tools/crawlora-mcp/airbnb-search.md
- `amazon_product` — Read — https://policylayer.com/tools/crawlora-mcp/amazon-product.md
- `amazon_search` — Read — https://policylayer.com/tools/crawlora-mcp/amazon-search.md
- `amazon_suggest` — Read — https://policylayer.com/tools/crawlora-mcp/amazon-suggest.md
- `anime_character` — Read — https://policylayer.com/tools/crawlora-mcp/anime-character.md
- `anime_character_search` — Read — https://policylayer.com/tools/crawlora-mcp/anime-character-search.md
- `anime_rankings` — Read — https://policylayer.com/tools/crawlora-mcp/anime-rankings.md
- `anime_search` — Read — https://policylayer.com/tools/crawlora-mcp/anime-search.md
- `anime_title_characters` — Read — https://policylayer.com/tools/crawlora-mcp/anime-title-characters.md
- `anime_title_recommendations` — Read — https://policylayer.com/tools/crawlora-mcp/anime-title-recommendations.md
- `anime_title_staff` — Read — https://policylayer.com/tools/crawlora-mcp/anime-title-staff.md
- `apple_podcasts_charts` — Read — https://policylayer.com/tools/crawlora-mcp/apple-podcasts-charts.md
- `apple_podcasts_episodes_search` — Read — https://policylayer.com/tools/crawlora-mcp/apple-podcasts-episodes-search.md
- `apple_podcasts_search` — Read — https://policylayer.com/tools/crawlora-mcp/apple-podcasts-search.md
- `apple_podcasts_show` — Read — https://policylayer.com/tools/crawlora-mcp/apple-podcasts-show.md
- `apple_podcasts_show_episodes` — Read — https://policylayer.com/tools/crawlora-mcp/apple-podcasts-show-episodes.md
- `appstore_app` — Read — https://policylayer.com/tools/crawlora-mcp/appstore-app.md
- …and 697 more: https://policylayer.com/tools/crawlora-mcp.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=crawlora-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/crawlora-mcp
