Metadata-Version: 2.5
Name: threadfox-lite
Version: 0.1.1
Summary: Read a subreddit's rules and check whether a Reddit post is still up, from Claude Code, Codex or any MCP client. Free tools from ThreadFox.
Project-URL: Homepage, https://threadfox.vip
Project-URL: Source, https://github.com/amflimited/threadfox-lite
Author-email: "AMF Indiana (ThreadFox)" <support@threadfox.vip>
License: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2,>=1.2.0
Description-Content-Type: text/markdown

# ThreadFox Lite

Free, read-only Reddit tools for 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.
- `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`: how to get the full ThreadFox kit (posting from your own Chrome, replies, an outcome ledger, a 12-module course).

No login, no posting, no Reddit API keys: each call is one request to Reddit's public JSON with a descriptive user agent.

## 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 (Settings > Extensions). It needs [uv](https://docs.astral.sh/uv/) on your machine.

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