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

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.4
File Size Uploaded
threadfox_lite-0.2.4.tar.gz 324.4 kB Details

Built distribution (wheel)

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

Total release size: 340.8 kB

Release files / threadfox_lite-0.2.4.tar.gz

Download URL threadfox_lite-0.2.4.tar.gz
Size 324.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8aaa7fd44c47360593bdea2a02f31d92b272a4862c0efdb661869c562239fe32
BLAKE2b-256 checksum
How to use checksums
018965374cbb8c0d355773e88b8ef78313881313d471e2f03bc4b023f2850265
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.4-py3-none-any.whl

Download URL threadfox_lite-0.2.4-py3-none-any.whl
Size 16.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc716d01962b48108b3d6f4e914d69c219f3df23cd69637e591294ed9ec3ad0a
BLAKE2b-256 checksum
How to use checksums
768f154b1212d1cc2adc4711b23e290e2440f67e0789e84636715e73d5ef568a
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

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

This release

0.2.4 This release

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