# text_frequency

utilpeek: Count word and n-gram frequencies in a text. For scored keyphrases use text_keywords. Returns the most frequent words or 2-3 word n-grams (n-grams never cross punctuation) with count and share, dropping stop words (en, es, fr, de, pt, it, nl, or none), and optionally character counts. Typically under 0.3 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day. The submitted text is never logged or stored. Docs: https://tanod.dev/learn/keyword-extraction-api.html

Agent View of the PolicyLayer registry record for `text_frequency`. HTML page: https://policylayer.com/tools/dev-tanod-tanod/text-frequency

## Facts

- Tool: `text_frequency`
- Server: Tanod (`https://tanod.dev/mcp`) — https://policylayer.com/tools/dev-tanod-tanod.md
- Homepage: https://github.com/https://tanod.dev/mcp
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server auth posture: open
- Server CORS policy: *
- Server rate-limited: no
- Parameters: 9 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | string | yes | The text (at most 200,000 characters). |
| `ngram` | integer | no | Term length in words: 1 (default), 2 or 3; n-grams never span punctuation. |
| `top_n` | integer | no | Most frequent terms to return (1-1000, default 50). |
| `language` | string | no | Stop-word list to drop (none = keep every word). |
| `characters` | boolean | no | Also count characters (whitespace excluded). |
| `min_length` | integer | no | Shortest word counted, in characters (1-50, default 1; single words only, ngram=1). |
| `case_sensitive` | boolean | no | Count "Word" and "word" apart (default false: terms are lowercased). |
| `include_numbers` | boolean | no | Also count numeric tokens such as 2026 (default false). |
| `remove_stopwords` | boolean | no | Drop the stop words of `language` (default true). |

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": "text_frequency",
    "arguments": {
      "text": "<text>"
    }
  }
}
```

## Why text_frequency is rated Low

Even though text_frequency 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.

## Use case

AI agents call text_frequency to retrieve information from Tanod 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 Tanod:

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

## Other tools on Tanod (307)

- `audit_token_approvals` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/audit-token-approvals.md
- `aurora_forecast` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/aurora-forecast.md
- `diff_text` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/diff-text.md
- `image_metadata` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/image-metadata.md
- `pdf_pipeline` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/pdf-pipeline.md
- `pdf_protect` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/pdf-protect.md
- `pdf_remove_pages` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/pdf-remove-pages.md
- `pdf_reorder_pages` — Destructive — https://policylayer.com/tools/dev-tanod-tanod/pdf-reorder-pages.md
- `build_ics_event` — Execute — https://policylayer.com/tools/dev-tanod-tanod/build-ics-event.md
- `build_pptx_deck` — Execute — https://policylayer.com/tools/dev-tanod-tanod/build-pptx-deck.md
- `build_xlsx_workbook` — Execute — https://policylayer.com/tools/dev-tanod-tanod/build-xlsx-workbook.md
- `bulk_agent_index` — Execute — https://policylayer.com/tools/dev-tanod-tanod/bulk-agent-index.md
- `cron_next_runs` — Execute — https://policylayer.com/tools/dev-tanod-tanod/cron-next-runs.md
- `decode_calldata` — Execute — https://policylayer.com/tools/dev-tanod-tanod/decode-calldata.md
- `expand_rrule` — Execute — https://policylayer.com/tools/dev-tanod-tanod/expand-rrule.md
- `html_to_pdf` — Execute — https://policylayer.com/tools/dev-tanod-tanod/html-to-pdf.md
- `image_crop` — Execute — https://policylayer.com/tools/dev-tanod-tanod/image-crop.md
- `parse_ics` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-ics.md
- `parse_phone_number` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-phone-number.md
- `parse_rss_feed` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-rss-feed.md
- `parse_sitemap` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-sitemap.md
- `parse_url` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-url.md
- `parse_user_agent` — Execute — https://policylayer.com/tools/dev-tanod-tanod/parse-user-agent.md
- `render_mermaid` — Execute — https://policylayer.com/tools/dev-tanod-tanod/render-mermaid.md
- `satellite_passes` — Execute — https://policylayer.com/tools/dev-tanod-tanod/satellite-passes.md
- `sec_financials` — Execute — https://policylayer.com/tools/dev-tanod-tanod/sec-financials.md
- `transcribe_audio` — Execute — https://policylayer.com/tools/dev-tanod-tanod/transcribe-audio.md
- `x402_well_known_file` — Execute — https://policylayer.com/tools/dev-tanod-tanod/x402-well-known-file.md
- `compare_stablecoin_transfer_fees` — Financial — https://policylayer.com/tools/dev-tanod-tanod/compare-stablecoin-transfer-fees.md
- `transfer_preflight` — Financial — https://policylayer.com/tools/dev-tanod-tanod/transfer-preflight.md
- …and 277 more: https://policylayer.com/tools/dev-tanod-tanod.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=dev-tanod-tanod · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/dev-tanod-tanod