Access X/Twitter (via Grok) and Reddit through x402-protected endpoints.
Setup
See rules/getting-started.md for installation and wallet setup.
Quick Reference
| Search X posts
| /api/grok/x-search
| $0.02
| Search tweets by keywords
| Find X users
| /api/grok/user-search
| $0.02
| Search users by criteria
| Get user posts
| /api/grok/user-posts
| $0.02
| Recent posts from user
| Search Reddit
| /api/reddit/search
| $0.02
| Search Reddit posts
| Get comments
| /api/reddit/post-comments
| $0.02
| Comments on a post
See rules/rate-limits.md for usage guidance.
X/Twitter via Grok
Search Posts
Search for X posts by keywords:
mcp__x402__fetch(
url="https://enrichx402.com/api/grok/x-search",
method="POST",
body={
"query": "AI agents"
}
)
Parameters:
query- Search keywords (required)
Returns:
-
Post text and author info
-
Engagement metrics (likes, retweets, replies)
-
Timestamps and URLs
-
Media attachments
Search Users
Find X users matching criteria:
mcp__x402__fetch(
url="https://enrichx402.com/api/grok/user-search",
method="POST",
body={
"query": "AI researcher San Francisco"
}
)
Returns:
-
Username and display name
-
Bio/description
-
Follower/following counts
-
Verification status
-
Profile links
Get User's Posts
Fetch recent posts from a specific user:
mcp__x402__fetch(
url="https://enrichx402.com/api/grok/user-posts",
method="POST",
body={
"username": "elonmusk"
}
)
Parameters:
username- X username without @ (required)
Returns: Recent posts with full engagement metrics.
Search Posts
Search Reddit for posts:
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/search",
method="POST",
body={
"query": "best programming languages 2024"
}
)
Parameters:
-
query- Search terms (required) -
subreddit- Limit to specific subreddit -
sort- relevance, hot, new, top -
time- hour, day, week, month, year, all
Returns:
-
Post title and content
-
Author and subreddit
-
Upvotes and comment count
-
Post URL
Search in Subreddit
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/search",
method="POST",
body={
"query": "typescript vs javascript",
"subreddit": "programming",
"sort": "top",
"time": "year"
}
)
Get Post Comments
Get comments from a Reddit post:
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/post-comments",
method="POST",
body={
"postUrl": "https://reddit.com/r/programming/comments/abc123/..."
}
)
Returns:
-
Comment text and author
-
Upvotes/downvotes
-
Reply threads
-
Comment timestamps
Workflows
Standard
(Optional) Check balance: mcp__x402__get_wallet_info
Use mcp__x402__discover_api_endpoints(url="https://enrichx402.com") to list all endpoints
Use mcp__x402__check_endpoint_schema(url="...") to see expected parameters and pricing
Call endpoint with mcp__x402__fetch
Parse and present results
Brand Monitoring
(Optional) Check balance: mcp__x402__get_wallet_info
Search X for brand mentions
Search Reddit for discussions
Summarize sentiment and key mentions
mcp__x402__fetch(
url="https://enrichx402.com/api/grok/x-search",
method="POST",
body={"query": "YourBrand OR @YourBrand"}
)
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/search",
method="POST",
body={"query": "YourBrand", "sort": "new"}
)
Competitor Research
Search Reddit for competitor reviews Search X for competitor mentions Analyze common complaints and praise
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/search",
method="POST",
body={"query": "competitor name review", "sort": "top", "time": "year"}
)
Influencer Discovery
Define criteria (topic, follower range) Search for matching users Get recent posts for top candidates
mcp__x402__fetch(
url="https://enrichx402.com/api/grok/user-search",
method="POST",
body={"query": "tech blogger 100k followers"}
)
Community Sentiment
Identify relevant subreddit Search for discussions on topic Get comments from top posts Synthesize overall sentiment
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/search",
method="POST",
body={"query": "new feature name", "subreddit": "relevant_community", "sort": "hot"}
)
mcp__x402__fetch(
url="https://enrichx402.com/api/reddit/post-comments",
method="POST",
body={"postUrl": "https://reddit.com/..."}
)
Response Data
X/Twitter Post Fields
-
text- Post content -
author- Username, display name, verified status -
metrics- Likes, retweets, replies, quotes, views -
createdAt- Timestamp -
url- Link to post -
media- Attached images/videos
X/Twitter User Fields
-
username- Handle without @ -
displayName- Full name -
description- Bio -
followers/following- Counts -
verified- Verification status -
profileImageUrl- Avatar
Reddit Post Fields
-
title- Post title -
selftext- Post body (for text posts) -
author- Username -
subreddit- Subreddit name -
score- Upvotes minus downvotes -
numComments- Comment count -
url- Link to post -
createdUtc- Timestamp
Reddit Comment Fields
-
body- Comment text -
author- Username -
score- Net upvotes -
replies- Nested replies -
createdUtc- Timestamp
Cost Estimation
| Quick X search | 1 | $0.02
| User profile + posts | 2 | $0.04
| Reddit thread + comments | 2 | $0.04
| Full monitoring scan | 4-6 | $0.08-0.12