Text Analysis

Readability Score

Calculates multiple readability metrics including Flesch-Kincaid Grade Level, Flesch Reading Ease, and SMOG index for any text. Use via MCP in Cursor or Windsurf for content analysis, or call GET /v1/text/readability with your text. Returns numerical scores and grade-level interpretations. Perfect for AI agents optimizing content accessibility and educational appropriateness.

API Endpoint

GET /v1/text/readability

Code Examples

curl "https://tinyfn.io/v1/text/readability" \
  -H "X-API-Key: YOUR_API_KEY"
const response = await fetch('https://tinyfn.io/v1/text/readability', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get('https://tinyfn.io/v1/text/readability',
    headers={'X-API-Key': 'YOUR_API_KEY'})
data = response.json()
print(data)

Use via MCP

Add to your AI agent

Connect your AI agent (Claude, Cursor, Windsurf, etc.) to TinyFn's text analysis tools:

{
  "mcpServers": {
    "tinyfn-text": {
      "url": "https://tinyfn.io/mcp/text",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Learn more about MCP setup →

FAQ

What readability scores does this tool calculate?

Returns Flesch-Kincaid Grade Level, Flesch Reading Ease (0-100 scale), SMOG index, and Automated Readability Index (ARI). Each uses different formulas based on sentence length and syllable count.

How do I interpret Flesch-Kincaid Grade Level scores?

Score represents U.S. school grade level needed to understand the text. Score of 8.5 means 8th-9th grade reading level, while 12+ indicates college-level complexity.

Can MCP tools use this for automated content optimization?

Yes, AI agents can analyze drafts and suggest simplifications based on target reading levels. Useful for documentation, marketing copy, and educational content workflows.

What's the minimum text length for accurate readability scoring?

Works with any length, but scores are most reliable with 100+ words. Very short texts may produce skewed results due to limited sentence and word variety.

Does it handle non-English text or technical jargon?

Designed for English text using standard syllable counting. Technical terms with many syllables will increase complexity scores, which may or may not reflect actual difficulty for domain experts.

Try Readability Score Now

Get your free API key and start using Readability Score in seconds.

Get Free API Key