topic-scorer
An MCP server that scores a page or draft against 11,485 public taxonomy categories, returns its rank per taxonomy, and gives you the phrases it still needs. Free, with no key.
Gehosteter MCP-Server
npx add-mcp 'https://topic-scorer.pixelcove.co/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
How it works
Three steps take a draft from a target category to a list of edits.
-
Look up the category id
topic_scorer_findsearches all six taxonomies by substring and returns matching ids and paths. -
Score the text against the target
topic_scorer_scoretakes up to 32,768 characters of text or HTML. One embedding, cosine similarity to every category, ranked per taxonomy. -
Act on the rank and the phrase bank
Read the rank and the gap to #1 rather than the raw score. Work the unused phrases into the draft, then score it again.
topic-scorer measures topical alignment. It doesn't predict where a page ranks in a search engine.
Taxonomies covered
Six public taxonomies, loaded whole. Every call ranks your text inside all of them.
| TAXONOMY | CATEGORIES |
|---|---|
| Google Ads Topics | 2,558 |
| Google Merchant | 5,595 |
| IAB Content 3.1 | 704 |
| IAB Audience 1.1 | 1,558 |
| IAB Ad Product 2.0 | 583 |
| LinkedIn Industries v2 | 487 |
total 11,485 categories / one embedding at 768 dimensions
Tools
Five tools on one endpoint. Text goes in as text: topic-scorer never fetches a URL for you.
| TOOL | WHAT IT RETURNS |
|---|---|
| topic_scorer_taxonomies | The six taxonomies with their label and category count. |
| topic_scorer_find | Categories whose path contains your query, with the id you pass to the scoring tools. |
| topic_scorer_score | Top categories per taxonomy, plus the target's rank, score, gap to #1, and a phrase bank split into used and unused. |
| topic_scorer_gate | A pass or fail against a rank threshold, for content pipelines that block a draft until it clears. |
| topic_scorer_phrases | The ranked phrase bank for one category: 1 to 4 word phrases a page on that topic contains. |
Limits
Every tool is free. Daily caps keep the embedding bill bounded, and all five tools count toward them.
| LIMIT | VALUE |
|---|---|
| Calls per caller | 50 per UTC day |
| Calls across all callers | 1,000 per UTC day |
| Text length | up to 32,768 characters |
Connect
Point any MCP client at the endpoint over streamable HTTP. You need no key.
MCP client config
MCP CLIENT CONFIG
{
"mcpServers": {
"topic-scorer": {
"type": "http",
"url": "https://topic-scorer.pixelcove.co/mcp"
}
}
}
Lookup with curl
CURL / TOPIC_SCORER_FIND
curl -sS https://topic-scorer.pixelcove.co/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,
"method":"tools/call",
"params":{"name":"topic_scorer_find",
"arguments":{"query":"network security",
"taxonomy":"google_ads_topics"}}}'
You get back the category id and its full path. Pass that id as category to topic_scorer_score, topic_scorer_gate, or topic_scorer_phrases.