Skip to main content
Glama
amflimited

threadfox-lite

Official
by amflimited
README.md
# ThreadFox Lite

Free, read-only Reddit tools for Claude Desktop, Claude Code, Codex and any MCP client, plus a `reddit-rules-first` agent skill.

- `subreddit_rules`: a subreddit's rules, size and description, with the self-promotion rules flagged. Call it before writing a post.
- `find_communities`: subreddits about a topic ("bakery marketing", "indie games"), each with its self-promotion rules flagged and whether it mentions a promo thread.
- `account_check`: a Reddit account's age, karma and standing, and whether its recent posts are removed or hidden from search (the practical sign of a spam filter or shadowban).
- `post_status`: whether a post is still live, removed by moderators or deleted, with score and comments. Check at 1, 6 and 24 hours.
- `threadfox_full_kit`: what the full ThreadFox kit adds (finding conversations where people ask for what you sell, posting from your own Chrome, replies, an outcome ledger, a 12-module course).

**Reads only, through your own signed-in Chrome.** Reddit now sends every signed-out request, including its public JSON, to a login page, so ThreadFox Lite reads the way you do: in your Chrome, signed in as you, one small read at a time. It never posts, votes or changes anything, and needs no Reddit API keys. One-time setup: Microsoft's [Playwright Extension](https://chromewebstore.google.com/detail/playwright-extension/mmlmfjhmonkocbjadbfplnigmagldckm) in the Chrome where you are signed in to Reddit. Node.js is fetched for you if you don't have it (the official build from nodejs.org into `~/.threadfox/runtime`, checked against its published SHA-256; nothing installed system-wide). It stays light on your computer: one Reddit read at a time across every ThreadFox app on the machine, and its Chrome connection closes after 10 idle minutes and never leaves background processes behind. The first read asks you to pick a tab in Chrome.

## Install

Claude Code plugin (the tools and the skill together):

    /plugin marketplace add amflimited/threadfox-lite
    /plugin install threadfox-lite@threadfox

Claude Code, the MCP server only:

    claude mcp add threadfox-lite -- uvx threadfox-lite

Claude Desktop: download the `.mcpb` file from the [latest release](https://github.com/amflimited/threadfox-lite/releases/latest) and open it; if Windows asks which app should open it, choose Claude. Claude Desktop sets up Python for it by itself.

Codex (`~/.codex/config.toml`):

    [mcp_servers.threadfox-lite]
    command = "uvx"
    args = ["threadfox-lite"]

Any other MCP client: run `uvx threadfox-lite` (the package is on [PyPI](https://pypi.org/project/threadfox-lite/)).

Bought ThreadFox on MCP Marketplace? Set `MCP_LICENSE_KEY` to your key, ask your AI to run `threadfox_full_kit`, or go straight to https://threadfox.vip/redeem.

## The skill

`skills/reddit-rules-first/SKILL.md` works on its own in any agent that reads skills: rules first, one post per community, disclose, check what stayed up. Install it anywhere with `npx skills add amflimited/threadfox-lite`.

Also listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=threadfox) as `io.github.amflimited/threadfox-lite`.

## About

Made by AMF Indiana, the team behind ThreadFox (https://threadfox.vip). Built from our own run: 978,227 recorded views from two days of posts (Sept 20-21 UTC), with no ad spend. Not affiliated with Reddit, OpenAI or Anthropic. MIT licence.

<!-- mcp-name: io.github.amflimited/threadfox-lite -->

TDQS

B3.4/5.0

Scored across 5 tools

Disambiguation4/5

Most tools target clearly distinct entities: account, community discovery, specific subreddit rules, and post status. The only mild overlap is between find_communities and subreddit_rules both touching rules, and account_check vs post_status both involving post removals, but their inputs and purposes are separated well enough.

Naming Consistency3/5

All names are snake_case and readable, but the pattern is mixed: account_check and post_status are noun-based, find_communities is verb-first, subreddit_rules is a noun phrase, and threadfox_full_kit is a product name. There is no consistent verb_noun convention, but the style is not chaotic.

Tool Count4/5

Five tools is a reasonable size for a focused Reddit helper server. One tool, threadfox_full_kit, is a promotional pointer to another product rather than a functional operation, which slightly reduces how well each tool earns its place.

Completeness2/5

The tools cover account health, community discovery, subreddit rules, and post status checking, but the workflow repeatedly references posting and writing posts, and there is no tool to actually create, edit, or delete a post. This is a significant gap for the apparent purpose of running a Reddit posting workflow.

Maintenance

ActivityMaintained
ResponsivenessNo issues