RESTMCPOpenAPI 3.1

Trend Signals API & MCP Server — for Creators, Builders & Agents

One stable Word v1 schema for emerging terms, sources, hot score, saturation, and agent-ready use cases.

Start with RESTOpenAPI JSON

Fetch today

curl -H "X-API-Key: tsm_your_key" \
  https://trendsmeter.com/v1/today?lang=en

MCP Server

Hosted endpoint for Claude, Cursor, Cline, and agent clients.

MCP config

{
  "mcpServers": {
    "trendsmeter": {
      "url": "https://trendsmeter.com/mcp",
      "headers": {
        "X-API-Key": "tsm_your_key"
      }
    }
  }
}

getTodayTrends

Returns schema_version 1 data from the same Neon feed as the website.

getWordDetail

Returns schema_version 1 data from the same Neon feed as the website.

searchWords

Returns schema_version 1 data from the same Neon feed as the website.

getStatus

Returns schema_version 1 data from the same Neon feed as the website.

REST API

Versioned routes for today's signal feed, word detail, archive, and status.

GET/v1/today

Today's word list

GET/v1/word/:slug

Single trend report

GET/v1/by-date/:YYYY-MM-DD

Specific date, Pro for older dates

GET/v1/last-week

7-day rolling archive, Pro

GET/v1/status

Public freshness and cron health

/llms.txt

Plain-text navigation for LLM clients.

/openapi.json

OpenAPI 3.1 schema for tool import.

/.well-known/ai-tools.json

Lightweight agent tool discovery.

Word Schema

Stable fields now, broader signal tags next.

Word v1

{
  "schema_version": "1",
  "slug": "claude-skills",
  "term": "Claude Skills",
  "category": "concept",
  "hot_score": 87,
  "saturation": 0.34,
  "trend_velocity": "rising",
  "domain_tags": ["ai"],
  "intent_tags": ["create", "build", "research"],
  "sources": [{ "platform": "hn", "url": "https://..." }]
}

Authentication

Use `X-API-Key` on authenticated REST and MCP calls. Free keys default to 100 calls/day.

Versioning

Breaking schema changes ship as parallel `/v2/` routes. Word v1 remains stable for agent integrations.