MCP for TechSnif
v3.3.1Give your AI assistant structured access to tech story clusters aggregated from TechCrunch, The Verge, Ars Technica, and dozens more outlets: coverage links, social discussion, articles, trending data, timelines, entities, and leaderboards. Use the hosted endpoint with zero install, or run the server locally. For the full picture on agent access, see our agents overview.
Quick Start
The fastest path is the hosted endpoint. Point any MCP client that supports remote servers at https://mcp.techsnif.com. No install, no API keys, no accounts.
{
"mcpServers": {
"TechSnif": {
"url": "https://mcp.techsnif.com"
}
}
}Prefer to run it locally? Add this to your Claude Desktop config and restart. Same tools, same data.
{
"mcpServers": {
"TechSnif": {
"command": "npx",
"args": ["-y", "@techsnif/mcp-server"]
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
The server is listed on the official MCP registry as com.techsnif/mcp and published on npm as @techsnif/mcp-server.
Other Clients
Using a different MCP client? Select yours for setup instructions:
No install needed. Point any MCP client that supports remote servers at https://mcp.techsnif.com:
{
"mcpServers": {
"TechSnif": {
"url": "https://mcp.techsnif.com"
}
}
}What You Can Do
Once connected, your AI assistant can:
Story Clusters
Browse top tech stories aggregated from dozens of outlets, ranked by prominence or newest first, filtered by tier, topic, or entity.
Social Discussion
Get direct links to exact tweets, Reddit threads, LinkedIn posts, and Bluesky posts for any story.
Search
Find story clusters and articles by keyword, ranked by relevance, with publisher filtering and pagination across the archive.
Trending and Timelines
Spot stories gaining momentum by velocity, replay how a story rose and faded, and poll changes since a timestamp.
TechSnif Articles
List, search, and read full TechSnif editorial coverage, including trending articles from the last 48 hours.
Entities and Leaderboards
List the companies, people, and products in the news, and rank which publications and journalists drive coverage.
Publisher Filter
Filter stories by lead publisher: "show me all TechCrunch stories" or "Verge coverage today".
Tech Events
See upcoming tech industry events and conferences with dates, locations, and links.
Tools
13 read-only tools are available, generated from the same contract that drives the hosted endpoint, the npm package, and the CLI, so this list always matches what ships:
get_top_storiesTop stories
Get tech story clusters from across the web. Each story aggregates coverage from multiple outlets (TechCrunch, The Verge, NYT, TechSnif, etc.) and includes links to social discussion (tweets, Reddit threads, LinkedIn posts). Sort by rank (prominence) or newest (most recently seen). Optionally filter by headline tier (1=standard, 2=major, 3=top story), publisher name, discussion platform, topic, or a "since" timestamp, and paginate with offset. Use get_story when you need full details or article body text.
| Parameter | Type | Description |
|---|---|---|
limit | number | Number of stories to return (default 20, max 80) |
offset | number | Number of stories to skip (pagination) |
sort | string | Sort order: "rank" (prominence, default) or "newest" (most recently seen) |
tier | number | Filter by headline tier: 1=standard, 2=major, 3=top story |
publisher | string | Filter by lead publisher name (e.g. "TechCrunch", "The Verge", "TechSnif") |
platform | string | Filter to stories discussed on this platform (e.g. "x", "bluesky", "threads", "linkedin", "forums", "mastodon") |
has_discussion | boolean | Only return stories that have social discussion links |
since | string | ISO 8601 date, only stories seen since this time (e.g. "2026-07-01") |
topic | string | Filter by topic slug (e.g. "ai", "security") |
entity | string | Filter by entity slug: only stories mentioning this company, person, or product (e.g. "openai"). Use list_entities to discover slugs. |
get_storyStory detail
Get full details of a story cluster by slug, including all coverage links from every outlet (TechCrunch, NYT, TechSnif, etc.), direct URLs to social discussion posts (exact tweets, Reddit threads, LinkedIn posts, Bluesky posts), and the full TechSnif article text if available. Use this to answer "show me the tweets about this story" or "what outlets covered this". Filter discussion by platform, coverage by publisher, or use brief mode to skip the article body.
| Parameter | Type | Description |
|---|---|---|
slug | string | The story cluster slug (required) |
platform | string | Filter discussion links to this platform only (e.g. "x", "bluesky", "threads") |
publisher | string | Filter coverage links by publisher name (e.g. "TechCrunch"). Does not affect the lead article or discussion links. |
brief | boolean | Show metadata and links only, skip the full TechSnif article body |
search_storiesSearch stories
Full-text search over story cluster headlines and excerpts, ranked by relevance. Returns matching story clusters with coverage links, discussion link counts, and TechSnif article references when available. Use get_story for full detail and article body text. Optionally filter by publisher and paginate with offset.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query, matches story headlines and excerpts (min 2 characters) (required) |
limit | number | Max results to return (default 10, max 50) |
offset | number | Number of results to skip (pagination) |
publisher | string | Filter by lead publisher name (e.g. "TechCrunch", "TechSnif") |
platform | string | Narrow displayed discussion links to this platform (e.g. "x", "bluesky") |
get_tech_eventsTech events
Get upcoming tech industry events (conferences, summits, expos) with dates, locations, and URLs.
| Parameter | Type | Description |
|---|---|---|
limit | number | Number of events to return (default 10, max 50) |
get_articlesTechSnif articles
List TechSnif editorial articles (original coverage written by TechSnif). Filter by category (AI, Startups, Venture, Robotics) or tag, and paginate with offset. Use get_article for the full body text.
| Parameter | Type | Description |
|---|---|---|
limit | number | Number of articles to return (default 10, max 50) |
offset | number | Number of articles to skip (pagination) |
category | string | Filter by category (e.g. "AI", "Startups", "Venture", "Robotics") |
tag | string | Filter by tag (e.g. "Security", "Fintech", "Open Source") |
get_articleArticle detail
Get a full TechSnif editorial article by slug, including the complete body text.
| Parameter | Type | Description |
|---|---|---|
slug | string | The article slug (required) |
brief | boolean | Show metadata and excerpt only, skip the full body |
search_articlesSearch articles
Full-text search over TechSnif editorial article titles and excerpts, ranked by relevance. Returns article summaries with category, tags, and publish dates. Use get_article for the full body text, and paginate with offset.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query, matches article titles and excerpts (min 2 characters) (required) |
limit | number | Max results to return (default 20, max 50) |
offset | number | Number of results to skip (pagination) |
get_trending_articlesTrending articles
Get trending TechSnif editorial articles from the last 48 hours, ranked by coverage heat and recency. Use get_article for the full body text.
| Parameter | Type | Description |
|---|---|---|
limit | number | Number of articles to return (default 5, max 20) |
get_story_timelineStory timeline
Get the ranking history of a story cluster by slug: a time series of snapshots with rank, headline tier, commentary count, and coverage count at each point. Use this to see how a story rose, peaked, or faded across the news cycle.
| Parameter | Type | Description |
|---|---|---|
slug | string | The story cluster slug (required) |
get_changesStory changes
Get story cluster changes since a timestamp: newly appeared clusters and updates to existing ones, each with a change type, a change time, and a story summary. Poll this to stay in sync with the TechSnif feed without refetching everything; pass the returned nextCursor as the next "since" value.
| Parameter | Type | Description |
|---|---|---|
since | string | ISO 8601 timestamp to read changes from (defaults to 24 hours ago) |
limit | number | Max changes to return (default 50, max 100) |
get_trending_storiesTrending stories
Get story clusters gaining momentum right now, ranked by velocity: how quickly coverage and discussion grew within a recent window. Each story includes its velocity score plus commentary and coverage deltas. Use get_story for full detail.
| Parameter | Type | Description |
|---|---|---|
hours | number | Look-back window in hours (default 24, max 48) |
limit | number | Number of stories to return (default 20, max 50) |
get_leaderboardCoverage leaderboard
Get TechSnif source or author leaderboards: which publications and journalists drive the most tech story coverage. Rank by story count over a 7-day, 30-day, or all-time window, optionally filtered by topic.
| Parameter | Type | Description |
|---|---|---|
tab | string | Rank "sources" (publications) or "authors" (journalists) |
window | string | Time window for rankings (default 30d) |
topic | string | Filter by topic slug (e.g. "ai", "security") |
limit | number | Number of entries to return (default 50, max 100) |
list_entitiesEntities
List the companies, people, and products TechSnif tracks across story clusters, with story counts. Only entities linked to at least one story are returned, most-covered first. Pass a returned slug as the entity param of get_top_stories to pull every story about that entity.
| Parameter | Type | Description |
|---|---|---|
type | string | Filter by entity type: company, person, or product |
limit | number | Number of entities to return (default 100, max 500) |
Resources
Three read-only resources are available for context:
| URI | Description |
|---|---|
techsnif://categories | All categories with descriptions |
techsnif://tags | All tags with descriptions |
techsnif://platforms | Active social discussion platforms with story counts |
Example Prompts
Try these once your MCP connection is active:
- "Show me the top stories right now"
- "What stories are trending in the last 24 hours?"
- "Search TechSnif for stories about OpenAI"
- "Show me the tweets about the Meta lawsuit story"
- "How did that story rank over the last two days?"
- "Which companies are in the news this week?"
- "Which outlets drive the most AI coverage?"
- "Any upcoming tech events?"
API Endpoints
The MCP server calls TechSnif's public JSON API. You can also use these endpoints directly. The full surface is described in the OpenAPI 3.1 spec.
GET /api/stories
Story clusters. Query params: limit, offset, sort (rank|newest), tier, publisher, platform, has_discussion, since, topic, entity
GET /api/stories/search
Search story clusters. Query params: q (required), limit, offset, publisher, mode (keyword or semantic; semantic ranks by embedding similarity and matches paraphrases, and the response reports which mode ran)
GET /api/stories/:slug
Full story cluster with all coverage links and social discussion URLs.
GET /api/stories/:slug/timeline
Ranking history: rank, tier, commentary count, and coverage count per pipeline snapshot.
GET /api/stories/changes
Story clusters added or updated since a timestamp, with nextCursor for polling. Query params: since, limit
GET /api/stories/trending
Stories ranked by coverage and discussion velocity. Query params: hours, limit
GET /api/stream
Live server-sent events stream of story.new and story.updated events. Optional topics and tier filters, resume with Last-Event-ID, and the same URL accepts a WebSocket upgrade. Status at GET /api/stream/status, or watch it live in your browser.
POST /api/webhooks
Register an https endpoint for push deliveries of story events: challenge handshake on registration, HMAC-signed deliveries. Details in the webhooks section of the agents overview.
GET /api/articles
TechSnif editorial articles. Query params: limit, offset, category, tag. Also /api/articles/:slug, /api/articles/search, and /api/articles/trending.
GET /api/entities
Companies, people, and products TechSnif tracks, with story counts. Query params: type, limit. Pass a slug as the entity param of /api/stories.
GET /api/leaderboard
Source and author leaderboards. Query params: tab (sources|authors), window (7d|30d|all), topic, limit
GET /api/events
Upcoming tech events. Query params: limit
GET /api/mcp
Machine-readable MCP package, tool, resource, and setup metadata. POST to the same route (or https://mcp.techsnif.com) for the hosted JSON-RPC endpoint.
GET /openapi.json
OpenAPI 3.1 description of every public endpoint.
What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external data sources. Instead of copy-pasting links into your chat, MCP gives your assistant direct, structured access to story clusters aggregated from across the tech press.
No API keys are required. Use the hosted endpoint at https://mcp.techsnif.com, or run the server locally with npx; both read from TechSnif's public API. It's free, open source, and works with any MCP-compatible client.
MCP questions people search for
This page answers the practical setup and access questions developers usually ask before installing a news MCP server.
What is the best way to give an AI agent access to TechSnif?
If your assistant supports MCP, point it at the hosted endpoint at mcp.techsnif.com: no install, no keys, and the assistant gets direct tool access to story clusters, search, social discussion links, articles, trending data, timelines, entities, and leaderboards. Clients without remote MCP support can run the same server locally with npx.
Which MCP clients work with TechSnif?
The hosted endpoint at mcp.techsnif.com works with any client that supports remote MCP servers, including Cursor and Claude Code. The npx package works with Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex CLI, and any client that supports standard MCP server configuration.
Does the TechSnif MCP server require API keys?
No. Both the hosted endpoint at mcp.techsnif.com and the local npx server read from TechSnif public endpoints, so there is no TechSnif account, API key, or paywall required.
Is the TechSnif MCP server on the official registry?
Yes. It is listed on the official MCP registry at registry.modelcontextprotocol.io under the name com.techsnif/mcp, and published on npm as @techsnif/mcp-server.
What can an AI agent do with the TechSnif MCP server?
An agent gets 13 read-only tools: browse and search story clusters, pull full coverage and social discussion links, read TechSnif articles, track trending stories and ranking timelines, poll changes since a timestamp, list tracked companies and people, and rank sources and authors on the coverage leaderboard.