rnkflow-mcp

MCP server for RNKFLOW — real-time ranked tech intelligence feed.

Get live-ranked stories from Hacker News, arXiv, Dev.to, Ars Technica, Product Hunt, and more, directly inside Claude, Cursor, Windsurf, or any MCP-compatible agent.

Requirements

• Node.js 18+
• An active RNKFLOW Pro subscription
• An RNKFLOW API key (Settings > API Keys after subscribing)

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rnkflow": {
      "command": "npx",
      "args": ["-y", "rnkflow-mcp"],
      "env": {
        "RNKFLOW_API_KEY": "rnk_your_key_here"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rnkflow": {
      "command": "npx",
      "args": ["-y", "rnkflow-mcp"],
      "env": {
        "RNKFLOW_API_KEY": "rnk_your_key_here"
      }
    }
  }
}

Other MCP clients

Run directly:

RNKFLOW_API_KEY=rnk_your_key_here npx rnkflow-mcp

Tools

get_feed

Get the current ranked tech feed.

| Parameter | Type | Default | Description | |------------|--------|---------|-------------| | category | string | all | all, ai, tech, code, science, space, robotics, security, showhn | | limit | number | 20 | Stories to return (1-50) | | offset | number | 0 | Pagination offset |

list_sources

List all available feed categories with descriptions.

search_feed

Search the current feed by keyword.

| Parameter | Type | Default | Description | |------------|--------|---------|-------------| | query | string | — | Keyword or phrase to search for | | category | string | all | Limit search to a specific category | | limit | number | 10 | Maximum results to return |

Example prompts

• "What are the top tech stories right now?"
• "Show me the latest AI research papers from RNKFLOW"
• "Search the feed for anything about Rust"
• "What are people on Hacker News talking about today?"
• "Show me the top 5 Show HN projects this hour"

Data sources

RNKFLOW aggregates and ranks stories from:

• Hacker News
• arXiv (cs.AI, cs.LG, cs.CL, cs.RO, and more)
• Dev.to
• Ars Technica
• Product Hunt
• New Atlas
• IEEE Spectrum
• SpaceNews
• CISA security alerts
• and more

Rankings update every 5-30 seconds.

License

MIT