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 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 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).

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

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
File Size Uploaded
threadfox_lite-0.2.8.tar.gz 335.2 kB Details

Built distribution (wheel)

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

Total release size: 359.3 kB

Release files / threadfox_lite-0.2.8.tar.gz

Download URL threadfox_lite-0.2.8.tar.gz
Size 335.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1fee3432aa83557b8479ecf62f02d927c1a68db08f5af65923e8575737636e26
BLAKE2b-256 checksum
How to use checksums
2c6b09624363ac852d53f40ab441fdb0bbad7da25f46dafd83f7229891a68eb3
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-py3-none-any.whl

Download URL threadfox_lite-0.2.8-py3-none-any.whl
Size 24.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c4a75a1bd3a6d742ac11b55aaa147b32b099a9d4c044b0f3e94313d4edcc395a
BLAKE2b-256 checksum
How to use checksums
d2aded7ce12ed149ab3b1d0b26d65e7ec638051f496472b0287be5b88bdb6623
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 This release

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