Skip to main content

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 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:

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

Claude Desktop: download threadfox-lite-0.2.8.mcpb 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).

The source repository and the Claude Code plugin marketplace are temporarily unavailable on GitHub. The installation methods above work without GitHub.

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

Download reddit-rules-first and save it as SKILL.md in a reddit-rules-first folder in your agent's skills directory. It works on its own in any agent that reads skills: rules first, one post per community, disclose, check what stayed up.

Also listed in the official MCP Registry 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.

Metadata

Release files for threadfox-lite 0.2.8.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for threadfox-lite 0.2.8.post1
File Size Uploaded
threadfox_lite-0.2.8.post1.tar.gz 335.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for threadfox-lite 0.2.8.post1
File Interpreter ABI Platform
threadfox_lite-0.2.8.post1-py3-none-any.whl Python 3 none any Details

Total release size: 359.5 kB

Release files / threadfox_lite-0.2.8.post1.tar.gz

Download URL threadfox_lite-0.2.8.post1.tar.gz
Size 335.3 kB
Tags Source
SHA-256 checksum
How to use checksums
7e4faa69f7638506cc978f15d9f4e15300fa152dfe9a9725b6389531925bbf82
BLAKE2b-256 checksum
How to use checksums
574118e11d20467c6edb59a94598e4550ae3b0e58fe922620173b8ca19c445bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / threadfox_lite-0.2.8.post1-py3-none-any.whl

Download URL threadfox_lite-0.2.8.post1-py3-none-any.whl
Size 24.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d775d520ba811f61cf4e6c8809a60ad9c4bec19e4bc03828cf3e37fea674ad50
BLAKE2b-256 checksum
How to use checksums
bf057604aec07d4c106d5b581b2667729bbc55b1a36f306ab260246e0ca524ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

0.2.9

2 release files

This release

0.2.8.post1 This release

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page