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

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

Built distribution (wheel)

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

Total release size: 354.9 kB

Release files / threadfox_lite-0.2.7.tar.gz

Download URL threadfox_lite-0.2.7.tar.gz
Size 332.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2e01d0085d9e24459cdc85f997e115d01a60411abba6f027bde2da03822a24c6
BLAKE2b-256 checksum
How to use checksums
ca1bfe31d07ae925b336bb94dfd175739c79a90f0dafe5b5d26a5fc4be38fe06
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.7-py3-none-any.whl

Download URL threadfox_lite-0.2.7-py3-none-any.whl
Size 22.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9ed87224047e63afa41d7f6b6aace7c447b46782e6e0c4f4d24c923e7acfe62d
BLAKE2b-256 checksum
How to use checksums
9955e2cd38681dd9e8d7975ff86452a1069b1dbcf98c2ade94f631904015db24
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

0.2.8

2 release files

This release

0.2.7 This release

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