threadfox-lite 0.1.1__tar.gz

threadfox_lite-0.1.1/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "threadfox",
+  "owner": {
+    "name": "ThreadFox",
+    "email": "support@threadfox.vip"
+  },
+  "metadata": {
+    "description": "Reddit tools for Claude Code from ThreadFox."
+  },
+  "plugins": [
+    {
+      "name": "threadfox-lite",
+      "source": "./",
+      "description": "Free, read-only Reddit tools: subreddit rules before you post, post status after, and the reddit-rules-first skill.",
+      "version": "0.1.1",
+      "category": "marketing",
+      "homepage": "https://threadfox.vip"
+    }
+  ]
+}

threadfox_lite-0.1.1/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "threadfox-lite",
+  "version": "0.1.1",
+  "description": "Free, read-only Reddit tools: read a subreddit's rules before posting and check whether a post stayed up, plus the reddit-rules-first skill.",
+  "author": {
+    "name": "ThreadFox (AMF Indiana)",
+    "email": "support@threadfox.vip",
+    "url": "https://threadfox.vip"
+  },
+  "homepage": "https://threadfox.vip",
+  "repository": "https://github.com/amflimited/threadfox-lite",
+  "license": "MIT",
+  "keywords": ["reddit", "subreddit-rules", "marketing", "mcp", "skills"],
+  "mcpServers": {
+    "threadfox-lite": {
+      "command": "uv",
+      "args": ["run", "--directory", "${CLAUDE_PLUGIN_ROOT}", "threadfox-lite"]
+    }
+  }
+}

threadfox_lite-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,100 @@
+name: Publish
+
+# Push a tag vX.Y.Z (matching pyproject.toml and manifest.json) to publish that version to PyPI
+# (trusted publishing, no token), attach the Claude Desktop bundle to a GitHub release and update
+# the entry in the official MCP Registry (GitHub OIDC, namespace io.github.amflimited).
+# Each step skips what already exists, so a version uploaded to PyPI by hand, or a re-run, is fine.
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: astral-sh/setup-uv@v6
+
+      - name: Check the tag matches the package version
+        run: |
+          V="${GITHUB_REF_NAME#v}"
+          grep -q "^version = \"$V\"" pyproject.toml
+          grep -q "\"version\": \"$V\"" manifest.json
+          echo "VERSION=$V" >> "$GITHUB_ENV"
+
+      - name: Already on PyPI?
+        id: pypi
+        run: |
+          if curl -sf "https://pypi.org/pypi/threadfox-lite/$VERSION/json" > /dev/null; then echo "exists=true" >> "$GITHUB_OUTPUT"; else echo "exists=false" >> "$GITHUB_OUTPUT"; fi
+
+      - name: Test
+        run: uv run python -m unittest discover -s tests
+
+      - name: Build
+        if: steps.pypi.outputs.exists != 'true'
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.pypi.outputs.exists != 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: "lts/*"
+
+      - name: Build the Claude Desktop bundle
+        run: npx -y @anthropic-ai/mcpb pack . "threadfox-lite-$VERSION.mcpb"
+
+      - name: GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if gh release view "$GITHUB_REF_NAME" > /dev/null 2>&1; then
+            rm -f "threadfox-lite-$VERSION.mcpb"
+            gh release download "$GITHUB_REF_NAME" --pattern "threadfox-lite-$VERSION.mcpb"
+            echo "SHA=$(sha256sum "threadfox-lite-$VERSION.mcpb" | cut -d' ' -f1)" >> "$GITHUB_ENV"
+            exit 0
+          fi
+          SHA=$(sha256sum "threadfox-lite-$VERSION.mcpb" | cut -d' ' -f1)
+          echo "SHA=$SHA" >> "$GITHUB_ENV"
+          gh release create "$GITHUB_REF_NAME" "threadfox-lite-$VERSION.mcpb" --title "ThreadFox Lite $VERSION" --notes "Free, read-only Reddit tools for Claude, Claude Code, Codex and any MCP client: subreddit_rules and post_status, plus the reddit-rules-first skill.
+
+          **Any MCP client:** \`uvx threadfox-lite\` (PyPI)
+          **Claude Code plugin:** \`/plugin marketplace add amflimited/threadfox-lite\`, then \`/plugin install threadfox-lite@threadfox\`
+          **Claude Desktop:** download threadfox-lite-$VERSION.mcpb below and open it (needs uv).
+
+          SHA-256 of the bundle: $SHA"
+
+      - name: server.json for this version
+        run: |
+          jq --arg v "$VERSION" --arg sha "$SHA" '
+            .version = $v
+            | .packages |= map(
+                if .registryType == "pypi" then .version = $v
+                elif .registryType == "mcpb" then .identifier = "https://github.com/amflimited/threadfox-lite/releases/download/v\($v)/threadfox-lite-\($v).mcpb" | .fileSha256 = $sha
+                else . end)' server.json > server.out.json
+          mv server.out.json server.json
+          cat server.json
+
+      - name: Wait for PyPI to serve the release
+        run: |
+          for i in $(seq 1 30); do
+            curl -sf "https://pypi.org/pypi/threadfox-lite/$VERSION/json" > /dev/null && exit 0
+            sleep 10
+          done
+          exit 1
+
+      - name: Publish to the MCP Registry
+        run: |
+          if curl -sf "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.amflimited%2Fthreadfox-lite/versions/$VERSION" > /dev/null; then
+            echo "Registry already has $VERSION"; exit 0
+          fi
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_linux_amd64.tar.gz" | tar xz mcp-publisher
+          ./mcp-publisher login github-oidc
+          ./mcp-publisher publish server.json

threadfox_lite-0.1.1/.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+.venv/
+dist/

threadfox_lite-0.1.1/.mcpbignore

@@ -0,0 +1,12 @@
+.git/
+.github/
+.venv/
+dist/
+tests/
+__pycache__/
+*.pyc
+uv.lock
+server.json
+glama.json
+LAUNCHGUIDE.md
+*.mcpb

threadfox_lite-0.1.1/LAUNCHGUIDE.md

@@ -0,0 +1,41 @@
+# ThreadFox
+
+## Tagline
+Reddit tools for Claude Code and Codex: rules first, posts that fit, checks that they stayed up.
+
+## Description
+ThreadFox gives your AI the Reddit job. Buying on MCP Marketplace gets you the full ThreadFox kit: your Claude Code or Codex reads each community's rules, writes a post that fits that community, publishes it from your own signed-in Chrome (no Reddit API keys, no exported cookies), answers the comments, and records every outcome in a ledger, stopping where a community removed you. It includes a 12-module course, 48 prompts and a one-command install for Windows, Mac and Linux.
+
+This server (ThreadFox Lite) runs locally and gives every user two free, read-only tools: subreddit_rules and post_status. Your license key opens the full kit: set MCP_LICENSE_KEY, run threadfox_full_kit, or redeem the key at https://threadfox.vip/redeem for your private library.
+
+Built from our own run: 978,227 recorded views from two days of posts (Sept 20-21 UTC), with no ad spend. That is our result, not a promise about yours. Made by AMF Indiana; not affiliated with Reddit, OpenAI or Anthropic.
+
+## Setup Requirements
+MCP_LICENSE_KEY (optional): your MCP Marketplace license key. The two read-only tools work without it. Requires uv (uvx) and Python 3.10+.
+
+## Category
+Marketing
+
+## Use Cases
+Reddit marketing, Product launches, Community research, Content distribution, Social media automation
+
+## Features
+- subreddit_rules: rules, size and description of any subreddit, with self-promotion rules flagged
+- post_status: live, removed or deleted, with score and comment count
+- Full kit with a license: publishing from your own Chrome, replies, outcome ledger, 12-module course, 48 prompts
+- No Reddit API keys, no login for the free tools
+- Works with Claude Code, Codex and other MCP clients
+
+## Getting Started
+- "Read the rules of r/SaaS and tell me whether I can post my launch there."
+- "Is https://www.reddit.com/r/SideProject/comments/abc123/my_post/ still up?"
+- "How do I open the full ThreadFox kit?"
+- Tool: subreddit_rules(subreddit)
+- Tool: post_status(url)
+- Tool: threadfox_full_kit()
+
+## Tags
+reddit, marketing, claude-code, codex, mcp, community, launch, growth, social-media, ai-agents
+
+## Documentation URL
+https://github.com/amflimited/threadfox-lite

threadfox_lite-0.1.1/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 AMF Indiana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

threadfox_lite-0.1.1/PKG-INFO

@@ -0,0 +1,58 @@
+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 -->

threadfox_lite-0.1.1/README.md

@@ -0,0 +1,44 @@
+# 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 -->

threadfox_lite-0.1.1/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["amflimited"]
+}

threadfox_lite-0.1.1/manifest.json

@@ -0,0 +1,39 @@
+{
+  "manifest_version": "0.4",
+  "name": "threadfox-lite",
+  "display_name": "ThreadFox Lite",
+  "version": "0.1.1",
+  "description": "Read a subreddit's rules and check whether a Reddit post is still up. Free, read-only tools from ThreadFox.",
+  "long_description": "Two free, read-only Reddit tools for Claude and any MCP client. subreddit_rules returns a subreddit's rules, size and description and flags the rules that mention self-promotion, so your AI reads them before it writes a post. post_status tells you whether a post is still live, removed by moderators or deleted, with its score and comment count. No login, no posting and no Reddit API keys: each call is one request to Reddit's public JSON. Reddit blocks many cloud and VPN networks, so run it from your own computer. The full ThreadFox kit (posting from your own Chrome, replies, an outcome ledger, a 12-module course) is sold separately at https://threadfox.vip.",
+  "author": {
+    "name": "AMF Indiana (ThreadFox)",
+    "email": "support@threadfox.vip",
+    "url": "https://threadfox.vip"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amflimited/threadfox-lite"
+  },
+  "homepage": "https://threadfox.vip",
+  "support": "https://threadfox.vip/help",
+  "icon": "icon.png",
+  "server": {
+    "type": "uv",
+    "entry_point": "src/threadfox_lite/server.py",
+    "mcp_config": {
+      "command": "uv",
+      "args": ["run", "--directory", "${__dirname}", "threadfox-lite"]
+    }
+  },
+  "tools": [
+    {"name": "subreddit_rules", "description": "A subreddit's rules, size and description, with the self-promotion rules flagged."},
+    {"name": "post_status", "description": "Whether a Reddit post is still live, removed by moderators or deleted, with score and comments."},
+    {"name": "threadfox_full_kit", "description": "What the full ThreadFox kit adds and where to get it."}
+  ],
+  "keywords": ["reddit", "subreddit", "rules", "marketing", "claude-code", "codex", "mcp"],
+  "license": "MIT",
+  "compatibility": {
+    "platforms": ["darwin", "linux", "win32"],
+    "runtimes": {"python": ">=3.10"}
+  }
+}

threadfox_lite-0.1.1/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "threadfox-lite"
+version = "0.1.1"
+description = "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."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "AMF Indiana (ThreadFox)", email = "support@threadfox.vip" }]
+dependencies = ["mcp>=1.2.0,<2", "httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://threadfox.vip"
+Source = "https://github.com/amflimited/threadfox-lite"
+
+[project.scripts]
+threadfox-lite = "threadfox_lite.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/threadfox_lite"]

threadfox_lite-0.1.1/server.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.amflimited/threadfox-lite",
+  "title": "ThreadFox Lite",
+  "description": "Read subreddit rules before posting and check whether a Reddit post is still up. Free and read-only.",
+  "version": "0.1.1",
+  "websiteUrl": "https://threadfox.vip",
+  "repository": {
+    "url": "https://github.com/amflimited/threadfox-lite",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "threadfox-lite",
+      "version": "0.1.1",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "mcpb",
+      "identifier": "https://github.com/amflimited/threadfox-lite/releases/download/v0.1.1/threadfox-lite-0.1.1.mcpb",
+      "fileSha256": "0000000000000000000000000000000000000000000000000000000000000000",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

threadfox_lite-0.1.1/skills/reddit-rules-first/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: reddit-rules-first
+description: Post to Reddit the way communities accept it. Read each subreddit's rules before writing, write one post per community, disclose affiliation, and check afterwards whether the post stayed up. Use when an agent is asked to share, launch or promote something on Reddit.
+---
+
+# Reddit, rules first
+
+Most Reddit promotion fails for the same reasons: the post ignores the community's rules, the same text goes to many subreddits, or nobody checks whether it was removed. Follow these steps every time.
+
+## Before writing
+
+1. Pick communities where your product answers a question people there already ask. Fit comes before size.
+2. Read each community's rules the day you post. With the ThreadFox Lite MCP server, call `subreddit_rules`; otherwise open `https://www.reddit.com/r/<name>/about/rules` and the sidebar.
+3. Look for: self-promotion limits (for example a 10% rule), a weekly promo thread, required flair, link bans, account age or karma minimums. If self-promotion isn't allowed, use the promo thread or don't post the link.
+
+## Writing
+
+4. Write a new title and body for each community. Never paste the same post twice.
+5. Say it's yours in the first lines ("I built this", "I'm with the team").
+6. Lead with something useful on its own: what you learned, real numbers, a how-to. The link is the footnote.
+
+## Posting
+
+7. Space posts out: minutes between them, never a burst of communities in one hour.
+8. Stay for the comments and answer real questions in the first few hours.
+
+## After posting
+
+9. Check at 1, 6 and 24 hours whether each post is still up (ThreadFox Lite: `post_status`).
+10. If a community removes you twice, stop posting there. Don't repost removed content.
+
+## Want the posting done for you?
+
+The full ThreadFox kit gives Claude Code or Codex the tools to do all of this from your own Chrome: it reads the rules, writes a post that fits each community, publishes it, answers comments and keeps a ledger of every outcome. https://threadfox.vip

threadfox_lite-0.1.1/src/threadfox_lite/__init__.py

@@ -0,0 +1,2 @@
+"""ThreadFox Lite: free, read-only Reddit tools for AI agents."""
+__version__ = "0.1.1"

threadfox_lite-0.1.1/src/threadfox_lite/reddit.py

@@ -0,0 +1,88 @@
+"""Read-only calls to Reddit's public JSON. No login, no posting, one request per tool call."""
+import re
+from urllib.parse import urlsplit
+
+import httpx
+
+UA = "threadfox-lite/0.1.1 (+https://threadfox.vip; read-only rules and post-status checks)"
+PROMO = re.compile(r"self[- ]?promo|promot|advertis|spam|affiliate|referral|\b10\s*%|link[- ]?drop|no links?\b|marketing|sell|product|business", re.I)
+SUB = re.compile(r"^[A-Za-z0-9_]{2,21}$")
+
+
+BLOCKED = ("Reddit refused this network (it blocks many servers, VPNs and cloud machines). Run the tool from your own "
+           "computer's connection, or open the page in a browser.")
+
+
+def _blocked(resp):
+    """Reddit's network block is a 403 whose body is not JSON (plain 'Blocked'); a private subreddit's 403 is JSON."""
+    if resp.status_code != 403:
+        return False
+    try:
+        resp.json()
+        return False
+    except ValueError:
+        return True
+
+
+def _client(transport=None):
+    return httpx.Client(headers={"User-Agent": UA}, timeout=15, follow_redirects=True, transport=transport)
+
+
+def subreddit_rules(name: str, transport=None) -> dict:
+    name = name.strip().removeprefix("/").removeprefix("r/").strip("/")
+    if not SUB.match(name):
+        return {"error": "Give a subreddit name like 'SaaS' or 'r/SaaS'."}
+    with _client(transport) as c:
+        rules = c.get(f"https://www.reddit.com/r/{name}/about/rules.json")
+        about = c.get(f"https://www.reddit.com/r/{name}/about.json")
+    blocked = _blocked(rules) or _blocked(about)
+    if blocked:
+        return {"subreddit": name, "error": BLOCKED, "open_instead": f"https://www.reddit.com/r/{name}/about/rules"}
+    if rules.status_code in (403, 404) or about.status_code in (403, 404):
+        return {"subreddit": name, "error": f"r/{name} is private, banned or does not exist (HTTP {rules.status_code})."}
+    if rules.status_code == 429 or about.status_code == 429:
+        return {"subreddit": name, "error": "Reddit rate-limited this request. Wait a minute and try again."}
+    rules.raise_for_status(); about.raise_for_status()
+    data = about.json().get("data", {})
+    items = []
+    for r in rules.json().get("rules", []):
+        text = f"{r.get('short_name', '')}\n{r.get('description', '')}".strip()
+        items.append({"rule": r.get("short_name", ""), "details": (r.get("description") or "")[:1200],
+                      "applies_to": r.get("kind", "all"), "mentions_promotion": bool(PROMO.search(text))})
+    return {
+        "subreddit": data.get("display_name", name),
+        "subscribers": data.get("subscribers"),
+        "description": (data.get("public_description") or "")[:500],
+        "rules": items,
+        "promotion_rules": [i["rule"] for i in items if i["mentions_promotion"]],
+        "read_before_posting": "Follow every rule above. If a rule limits self-promotion, use the community's promo thread or don't post the link. Write a new post for this community; never paste the same post in several.",
+    }
+
+
+def post_status(url: str, transport=None) -> dict:
+    try:
+        parts = urlsplit(url.strip())
+    except ValueError:
+        return {"error": "Give a Reddit post URL."}
+    host = (parts.hostname or "").lower()
+    m = re.match(r"^/r/[^/]+/comments/([a-z0-9]+)", parts.path or "")
+    if not host.endswith("reddit.com") or not m:
+        return {"error": "Give a full post URL like https://www.reddit.com/r/SaaS/comments/abc123/title/"}
+    with _client(transport) as c:
+        resp = c.get(f"https://www.reddit.com/comments/{m.group(1)}.json", params={"raw_json": 1, "limit": 1})
+    if _blocked(resp):
+        return {"error": BLOCKED, "open_instead": url.strip()}
+    if resp.status_code == 404:
+        return {"status": "not_found", "id": m.group(1)}
+    if resp.status_code == 429:
+        return {"error": "Reddit rate-limited this request. Wait a minute and try again."}
+    resp.raise_for_status()
+    post = resp.json()[0]["data"]["children"][0]["data"]
+    removed = post.get("removed_by_category")
+    status = "removed" if removed else ("deleted" if post.get("author") == "[deleted]" or post.get("selftext") == "[deleted]" else "live")
+    return {
+        "status": status, "removed_by": removed, "title": post.get("title"), "subreddit": post.get("subreddit"),
+        "score": post.get("score"), "comments": post.get("num_comments"), "locked": post.get("locked"),
+        "created_utc": post.get("created_utc"), "permalink": "https://www.reddit.com" + (post.get("permalink") or ""),
+        "note": "Check again at 1, 6 and 24 hours. If a community removes you twice, stop posting there.",
+    }

threadfox_lite-0.1.1/src/threadfox_lite/server.py

@@ -0,0 +1,51 @@
+"""ThreadFox Lite MCP server (stdio).
+
+Two free, read-only tools any agent can use before and after posting to Reddit, plus `threadfox_full_kit`,
+which tells a paying customer how to open the full ThreadFox kit (posting from your own Chrome, replies,
+the outcome ledger and the course). The full kit is sold at https://threadfox.vip and on MCP Marketplace.
+"""
+import os
+
+from mcp.server.fastmcp import FastMCP
+
+from . import reddit
+
+mcp = FastMCP("threadfox-lite")
+
+
+@mcp.tool()
+def subreddit_rules(subreddit: str) -> dict:
+    """Read a subreddit's rules, size and description, and flag the rules that mention self-promotion.
+    Call this before writing any post for that community."""
+    return reddit.subreddit_rules(subreddit)
+
+
+@mcp.tool()
+def post_status(url: str) -> dict:
+    """Check whether a Reddit post is still live, removed by moderators or deleted, with its score and comments."""
+    return reddit.post_status(url)
+
+
+@mcp.tool()
+def threadfox_full_kit() -> dict:
+    """How to get the full ThreadFox kit: your AI reads the rules, writes a post that fits each community,
+    publishes from your own Chrome, answers comments and records every outcome."""
+    key = os.environ.get("MCP_LICENSE_KEY", "")
+    if key.startswith("mcp_live_"):
+        return {"licensed": True,
+                "next_step": "Open https://threadfox.vip/redeem, paste your MCP Marketplace license key and your email, and you land in your private ThreadFox library (one-command install, lessons, full download).",
+                "support": "support@threadfox.vip"}
+    return {"licensed": False,
+            "what_it_adds": ["Publishing from your own signed-in Chrome, no Reddit API keys", "Replies to comments",
+                             "A ledger of every post and outcome, and it stops where a community removed you",
+                             "12-module course, 48 prompts"],
+            "proof": "Built from our own run: 978,227 recorded views from two days of posts (Sept 20-21 UTC), with no ad spend. Our result, not a promise of yours.",
+            "get_it": "https://threadfox.vip ($49 once, 30-day refund) or ThreadFox on MCP Marketplace"}
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

threadfox_lite-0.1.1/tests/test_reddit.py

@@ -0,0 +1,42 @@
+import json, sys, unittest
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+import httpx
+from threadfox_lite import reddit
+
+def transport(routes):
+    def handler(request):
+        for key, (status, body) in routes.items():
+            if key in str(request.url):
+                return httpx.Response(status, json=body)
+        return httpx.Response(404, json={})
+    return httpx.MockTransport(handler)
+
+class Tools(unittest.TestCase):
+    def test_rules_flag_promotion(self):
+        t = transport({"/about/rules.json": (200, {"rules": [{"short_name": "No self-promotion", "description": "Keep promo to the weekly thread", "kind": "all"},
+                                                            {"short_name": "Be kind", "description": "", "kind": "all"}]}),
+                       "/about.json": (200, {"data": {"display_name": "SaaS", "subscribers": 400000, "public_description": "SaaS"}})})
+        r = reddit.subreddit_rules("r/SaaS", transport=t)
+        self.assertEqual(r["promotion_rules"], ["No self-promotion"])
+        self.assertEqual(r["subscribers"], 400000)
+        self.assertIn("error", reddit.subreddit_rules("not a sub!", transport=t))
+
+    def test_post_status(self):
+        live = [{"data": {"children": [{"data": {"title": "T", "subreddit": "SaaS", "score": 5, "num_comments": 2, "author": "me",
+                                                 "removed_by_category": None, "locked": False, "permalink": "/r/SaaS/comments/abc123/t/"}}]}}]
+        t = transport({"/comments/abc123.json": (200, live)})
+        self.assertEqual(reddit.post_status("https://www.reddit.com/r/SaaS/comments/abc123/t/", transport=t)["status"], "live")
+        live[0]["data"]["children"][0]["data"]["removed_by_category"] = "moderator"
+        self.assertEqual(reddit.post_status("https://old.reddit.com/r/SaaS/comments/abc123/t/", transport=t)["status"], "removed")
+        self.assertIn("error", reddit.post_status("https://example.com/x", transport=t))
+
+class Blocked(unittest.TestCase):
+    def test_network_block_is_reported_as_such(self):
+        t = httpx.MockTransport(lambda req: httpx.Response(403, text="Blocked"))
+        r = reddit.subreddit_rules("SaaS", transport=t)
+        self.assertIn("refused this network", r["error"])
+        self.assertIn("refused this network", reddit.post_status("https://www.reddit.com/r/SaaS/comments/abc123/t/", transport=t)["error"])
+
+if __name__ == "__main__":
+    unittest.main()