01

One analysis engine, four ways to use it

WEB

Web for people

Paste text, inspect full tables, compare results, and export evidence in a visual interface.

HTTP

API for apps and agents

Call eight stateless JSON operations with OpenAPI discovery, stable errors, and no API key.

CLI

CLI for automation

Analyze files, URLs, inline text, or stdin locally and return tables, JSON, or CSV.

MCP

MCP for AI agents

Expose the same eight local read-only operations as discoverable tools over stdio.

02

Connect the npm package to an MCP client

The MCP command starts a local stdio server. Text supplied to a tool stays inside that process; only explicit public URL inputs use the network.

npx --yes textanalysis-tools@0.1.2 mcp
{
  "mcpServers": {
    "textanalysis": {
      "command": "npx",
      "args": ["--yes", "textanalysis-tools@0.1.2", "mcp"]
    }
  }
}

03

Eight focused operations

Each tool has a bounded input schema and structured output. Agents can choose a focused operation instead of parsing a general-purpose report.

analyze_text

read-only · structured JSON · local execution

word_frequency

read-only · structured JSON · local execution

keyword_density

read-only · structured JSON · local execution

ngram_analysis

read-only · structured JSON · local execution

bag_of_words

read-only · structured JSON · local execution

compare_texts

read-only · structured JSON · local execution

tfidf

read-only · structured JSON · local execution

text_similarity

read-only · structured JSON · local execution

04

Use OpenAPI when HTTP is the better transport

The public API exposes the same analysis primitives for remote applications. Use the machine-readable contract for tool generation and the concise capability map for discovery.

Machine-readable discovery

https://textanalysis.tools/openapi.json
https://textanalysis.tools/llms.txt

05

Deterministic analysis, not generated judgment

  • No LLM is used to calculate the results.
  • Counts and formulas remain inspectable.
  • Local CLI and MCP text is not sent to textanalysis.tools.
  • Public URL inputs require a network request to that page.
  • Results are diagnostics, not guarantees about ranking or content quality.

WEB · API · CLI · MCP

Choose the interface that matches the workflow

Use MCP for local agent tools, CLI for shell automation, API for remote applications, or the web interface for manual review.

Read CLI and MCP documentation →