# Ape Wisdom MCP

> Ape Wisdom tracks market sentiment by pulling real-time mentions from Reddit and 4chan. It tells you what retail traders are actually talking about in stocks and crypto right now—the buzz before it becomes news. You can list all trending assets, check the overall market snapshot, or specifically find assets with the highest positive conversation volume.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** market-sentiment, cryptocurrency-tracking, stock-market-trends, social-listening, financial-data

## Description

This MCP connects your agent directly to the pulse of online finance. Instead of reading through thousands of noisy Reddit threads or 4chan posts manually, you ask for a summary. It processes social media mentions and gives you structured data on what people are talking about in both crypto and stocks. You can pinpoint which assets are gaining steam rapidly or whether the general mood around a ticker is positive or negative. Since Vinkius hosts this MCP, your agent gets access to all these insights through one place—no need to juggle multiple niche data sources. It's pure sentiment analysis on demand.

## Tools

### get_market_snapshot
Provides an immediate, combined summary of top trending stocks and cryptocurrencies right now.

### get_sentiment_leaders
Finds assets that are currently generating the most positive discussion across social media.

### get_top_gainers
Identifies assets whose mention volume has increased the fastest in the last 24 hours.

### list_all_trending
Lists all stocks and cryptocurrencies that are currently popular across every connected subreddit.

### list_trending_4chan
Gathers trending assets specifically from 4chan boards for a unique view of internet buzz.

### list_trending_crypto
Lists the top cryptocurrencies that are currently hot within dedicated crypto-focused subreddits.

### list_trending_stocks
Lists the top stocks that are trending on subreddits focused primarily on equities.

### list_trending_subreddit
Retrieves a list of popular assets from any specific subreddit you name.

### list_wallstreetbets
Lists the trending assets specifically pulled from the r/wallstreetbets community.

### search_ticker
Searches through all available lists to check on a specific stock or coin ticker symbol.

## Prompt Examples

**Prompt:** 
```
What are the top 10 trending stocks on Reddit right now?
```

**Response:** 
```
I've pulled the latest trending stocks. Currently, NVDA leads with 1,250 mentions, followed by TSLA and AAPL. The sentiment for NVDA is strongly positive at 0.78.
```

**Prompt:** 
```
Show me cryptocurrencies with the highest mention growth in the last 24 hours.
```

**Response:** 
```
The top gainers in social buzz are SOL (+450 mentions), PEPE (+320 mentions), and ETH (+280 mentions). SOL is seeing a significant spike in r/CryptoCurrency.
```

**Prompt:** 
```
Get a market snapshot of trending assets.
```

**Response:** 
```
Here's your market snapshot. For stocks, NVDA and AMD are dominating the conversation. For crypto, BTC and ETH remain at the top, with a surge in interest for modular blockchains.
```

## Capabilities

### Get a Market Overview
Retrieves a high-level summary of the top trending stocks and cryptocurrencies across all tracked boards.

### Check Sentiment Leaders
Identifies specific assets that are currently generating the highest positive social media conversation volume.

### Spot Emerging Trends
Lists assets that show the fastest increase in online mentions over the last 24 hours, suggesting sudden interest.

### List All Trending Assets
Gathers a comprehensive list of all stocks and cryptocurrencies currently trending across every connected subreddit.

### Isolate Board Trends
Filters the data to show only what's popular on specific communities, like r/wallstreetbets or crypto-focused subreddits.

## Use Cases

### Assessing pre-pump hype for a trade
A trader sees chatter about a smaller coin. They ask their agent to run 'get_top_gainers' and then check that specific coin using 'search_ticker.' If the tool shows high growth but moderate sentiment, they know the buzz is building fast, suggesting potential momentum.

### Comparing cross-market interest
A portfolio manager needs to see if recent stock market volatility (e.g., NVDA) is influencing crypto hype. They use 'list_trending_stocks' and then immediately run 'get_market_snapshot' to check for correlation in the top two sectors.

### Monitoring a brand mention
A social media manager needs to see if their client's token is trending. They use 'list_trending_subreddit,' specifying the relevant crypto board, and then check sentiment using 'get_sentiment_leaders' to gauge public reception.

### Quick status check on multiple assets
A reporter needs a quick summary for an article. They ask the agent for a general market overview using 'list_all_trending,' which immediately gives them a list of everything people are talking about, spanning both finance and culture.

## Benefits

- Stop guessing about hype. By running 'get_top_gainers,' you get concrete data showing which assets are suddenly getting massive attention, allowing you to jump on emerging trends before they hit the news cycle.
- Get instant context using 'get_market_snapshot.' Instead of checking two different dashboards for stocks and crypto, this single tool gives you a combined view of market interest.
- Pinpoint positive buzz with 'get_sentiment_leaders.' This helps you filter out just the assets where people are genuinely excited, letting you prioritize your research time effectively.
- Drill down into specific communities. If you only care about what's happening on r/wallstreetbets, running 'list_wallstreetbets' gives you a clean feed of that niche sentiment without noise from anywhere else.
- Deep dive analysis is easy. Use 'search_ticker' to check the current buzz around any asset—even if it’s not currently trending—to see its general online conversation volume.

## How It Works

The bottom line is you stop reading forums and start querying actionable, quantifiable trends.

1. First, connect your AI client to this MCP within Vinkius. No API key is needed because the data source is public.
2. Then, direct your agent with a query, asking it to pull specific trends—say, 'What's trending on 4chan?' or 'Give me a market snapshot.'
3. Your agent runs the tool and gets back structured data: a list of assets along with their associated sentiment scores.

## Frequently Asked Questions

**How do I check if a specific ticker is trending using list_all_trending?**
You run 'list_all_trending' first to get the full scope of buzz, and then you can narrow your focus by passing the specific ticker symbol to 'search_ticker.' This lets you verify its current popularity against the entire market backdrop.

**Can I only see crypto trends using list_trending_crypto?**
No, that tool is limited to crypto-focused subreddits. If you want a broader view of everything popular on all boards, use 'list_all_trending' instead.

**What does get_market_snapshot give me?**
It provides the fastest way to gauge overall market temperature by giving a high-level summary of top assets in both stock and crypto categories simultaneously. It’s your quick status check.

**Is list_trending_4chan reliable for trading?**
While it provides unique access to 4chan's buzz, you should treat the data with caution. Because it comes from a less curated source, always validate its findings by cross-referencing them with 'get_sentiment_leaders.' 

**How does get_sentiment_leaders calculate positive sentiment for an asset?**
It uses a proprietary scoring model that measures both the volume of mentions and the emotional tone of the language used. This score helps you compare assets objectively, regardless of their current market capitalization.

**If I use list_all_trending, can I filter out specific asset types like only stocks?**
No, `list_all_trending` gives a combined view across all available sources. If you need to restrict results to just stock tickers or crypto coins, run the dedicated tools: `list_trending_stocks` or `list_trending_crypto`.

**Does get_top_gainers calculate growth based on a specific time window?**
Yes. The function measures mention growth relative to the last 24 hours, which helps you identify sudden spikes in buzz rather than steady, long-term interest.

**When I use search_ticker, what information do I get besides just confirmation that the ticker exists?**
The tool confirms the ticker and provides a quick summary of its recent mention volume across all monitored boards. You get enough context to decide if you need to run deeper analysis.

**Is an API key required for Ape Wisdom?**
No, this server uses Ape Wisdom's public API v1.0, which does not require authentication for basic usage.

**Which social platforms are tracked?**
Ape Wisdom primarily tracks popular investment-related subreddits on Reddit (like r/wallstreetbets, r/stocks, r/CryptoCurrency) and the /biz/ board on 4chan.

**What does the sentiment value represent?**
The sentiment value indicates the general tone of the social conversation. Values closer to 1.0 indicate highly positive sentiment, while lower values suggest negative or cautious conversation.