---
name: reddit.surf.cascade.fyi
description: reddit.surf.cascade.fyi provides read-only access to Reddit content via the Reddit.Surf paid API, currently scoped to two specific subreddits: r/programming and r/ClaudeCode. It returns post listings with metadata and engagement metrics, plus subreddit-level metadata for r/programming.
host: reddit.surf.cascade.fyi
---

# reddit.surf.cascade.fyi

This host is a narrow Reddit data accessor targeting two specific communities — r/programming and r/ClaudeCode. It serves agents that need structured post listings or subreddit metadata without scraping Reddit directly. It does not cover arbitrary subreddits, comments, user profiles, or real-time streams.

## When to use this host

Use this host when an agent specifically needs recent post data or metadata from r/programming or r/ClaudeCode. It is not suitable for any other subreddit — there is no general-purpose subreddit lookup. Do not use it for comment-level data, user profile lookups, search across Reddit, or real-time event streaming. If broader Reddit access is needed (arbitrary subreddits, comments, search), use the official Reddit API or a more general Reddit data provider instead. The r/programming endpoint supports cursor-based pagination; r/ClaudeCode does not expose a cursor parameter.

## Capabilities

### Subreddit Metadata

Retrieves structural information about the r/programming subreddit itself, including description, subscriber count, and creation date. Useful for context-setting before or alongside post retrieval.

- **`fetch-subreddit-metadata`** — Returns subreddit metadata for r/programming including title, description, subscriber count, and creation date via the Reddit.Surf paid API.

### Post Listings

Fetches recent post listings from r/programming and r/ClaudeCode, including titles, authors, scores, comment counts, upvote ratios, permalinks, and body text. Supports pagination for r/programming.

- **`fetch-reddit-programming-posts`** — Returns recent posts from Reddit's r/programming subreddit including titles, authors, timestamps, permalinks, self-text, and engagement metrics, with pagination support.
- **`fetch-rclaudecode-posts`** — Fetches a list of recent posts from the r/ClaudeCode subreddit, including post metadata, scores, comment counts, and body text.

## Workflows

### r/programming Subreddit Context + Posts

*Use when an agent needs to present or analyze r/programming with both community context (subscriber count, description) and current post activity in a single pass.*

1. **`fetch-subreddit-metadata`** — Retrieve subreddit-level metadata including description and subscriber count to establish community context.
2. **`fetch-reddit-programming-posts`** — Fetch recent post listings to surface trending discussions and engagement metrics alongside the subreddit context.

## Skill reference

### `fetch-reddit-programming-posts`

**Reddit r/programming Posts** — Returns recent posts from Reddit's r/programming subreddit including titles, authors, timestamps, permalinks, self-text, and engagement metrics, with pagination support.

*Use when:* Use when an agent needs to retrieve recent posts from r/programming, such as surfacing trending programming discussions, monitoring subreddit activity, or aggregating post metadata including scores, comment counts, and upvote ratios.

*Not for:* Do not use for posts from other subreddits; this endpoint is scoped exclusively to r/programming. Not suitable for real-time streaming or comment-level data.

**Inputs:**

- `cursor` (string) — Pagination cursor returned from a previous response to fetch the next page of posts.

**Returns:** Returns a data array of up to 25 recent r/programming posts, each with id, title, author, permalink, selftext, created_at, time_ago, is_self flag, and public_metrics (score, num_comments, upvote_ratio).

**Example:** `GET https://reddit.surf.cascade.fyi/r/programming/posts`

---

### `fetch-subreddit-metadata`

**r/Programming Stream** — Returns subreddit metadata for r/programming including title, description, subscriber count, and creation date via the Reddit.Surf paid API.

*Use when:* Use when an agent needs structured metadata about the r/programming subreddit, such as its description, subscriber count, or creation date, without scraping Reddit directly.

*Not for:* Do not use for fetching post listings, comments, or user data; this endpoint returns subreddit-level metadata only, not individual posts or threads.

**Returns:** Returns a data object with the subreddit's id, name, title, full Markdown description, public_description, subscriber count, creation timestamp, and URL path.

**Example:** `GET https://reddit.surf.cascade.fyi/r/programming`

---

### `fetch-rclaudecode-posts`

**r/ClaudeCode Posts** — Fetches a list of recent posts from the r/ClaudeCode subreddit, including post metadata, scores, comment counts, and body text.

*Use when:* Use when an agent needs to retrieve recent Reddit posts from r/ClaudeCode, such as to monitor community discussions, surface trending topics, or gather post content and engagement metrics from that subreddit.

*Not for:* Do not use for posts from other subreddits; use a different subreddit endpoint instead. Not suitable for real-time streaming or comment-level data — this returns post-level listings only.

**Returns:** Returns a data array of r/ClaudeCode post objects, each with id, title, author, permalink, selftext, created_at, is_self, optional url/thumbnail, link_flair_text, and public_metrics (score, num_comments, upvote_ratio).

**Example:** `GET https://reddit.surf.cascade.fyi/r/ClaudeCode/posts`

---