Grok MCP Server — X Intelligence Platform

Real-time competitive intelligence and lead intent detection powered by Grok's native X access. The only Apify Actor with real X/Twitter data via xAI's native x_search tool.

What does Grok MCP Server do?

This Actor provides 14 tools for X/Twitter intelligence, AI chat, code assistance, and content analysis — all powered by xAI's Grok models.

Key capabilities:

• Brand Monitoring — Track mentions with sentiment analysis
• Lead Intent Detection — Find people actively seeking solutions
• Competitive Intelligence — Compare brands side-by-side
• Trend Analysis — See what's trending on X
• AI Chat — Conversational AI with Grok
• Code Tools — Generate, review, fix, and explain code

Why use this Actor?

Feature	This Actor	Traditional Scrapers
Real X/Twitter data	✅ Native API	❌ Scraping
Sentiment analysis	✅ Built-in	❌ Manual
Intent detection	✅ AI-powered	❌ None
Rate limits	✅ Official limits	⚠️ Blocks common
Data freshness	✅ Real-time	⚠️ Cached

How much does it cost?

xAI API is free until June 2025. After that, costs are based on xAI's token pricing. Typical runs use 1,000-10,000 tokens depending on the tool.

Apify platform costs are separate and based on compute units used (~0.01-0.05 CU per run).

Input

Field	Type	Required	Default	Description
xaiApiKey	String	Yes	—	Your xAI API key from console.x.ai
model	String	No	grok-2-latest	Model for chat/code tools
xModel	String	No	grok-4-fast	Model for X/Twitter tools (must be grok-4 family)
maxTokens	Integer	No	4096	Maximum response tokens (256-131072)
temperature	Number	No	0.7	Randomness: 0=deterministic, 2=creative
toolCall	Object	Yes	—	The tool to execute (see below)

Tool Call Structure

{
  "name": "grok_x_monitor",
  "arguments": {
    "query": "your search term",
    "hours_back": 24
  }
}

Available Tools

X/Twitter Intelligence Tools

🔍 grok_x_monitor — Brand Monitoring

Monitor brand mentions with sentiment analysis.

Arguments:

Field	Type	Default	Description
query	String	—	Brand or search term
sentiment_filter	String	any	positive, negative, neutral, or any
min_engagement	Integer	0	Minimum likes + retweets
hours_back	Integer	24	How far back to search
limit	Integer	20	Max results

Example:

{
  "name": "grok_x_monitor",
  "arguments": {
    "query": "Acme Corp",
    "sentiment_filter": "negative",
    "min_engagement": 10,
    "hours_back": 24,
    "limit": 20
  }
}

🎯 grok_x_intent — Lead Intent Detection

Find people expressing buying signals.

Arguments:

Field	Type	Default	Description
product_category	String	—	Product/service category
intent_types	Array	all	Types of intent to detect
exclude_brands	Array	[]	Brands to exclude
hours_back	Integer	48	How far back to search
limit	Integer	25	Max results

Intent Types:

• seeking_recommendation — "anyone recommend a..."
• expressing_frustration — "so frustrated with..."
• comparing_options — "X vs Y?"
• ready_to_switch — "thinking of switching from..."
• asking_for_help — "how do I..."

Example:

{
  "name": "grok_x_intent",
  "arguments": {
    "product_category": "CRM software",
    "intent_types": ["seeking_recommendation", "ready_to_switch"],
    "exclude_brands": ["Salesforce"],
    "hours_back": 48
  }
}

⚔️ grok_x_compete — Competitive Intelligence

Compare 2-5 brands side-by-side.

Arguments:

Field	Type	Default	Description
brands	Array	—	2-5 brand names to compare
aspect	String	general	Focus area (e.g., "customer support")
hours_back	Integer	168	How far back to search

Example:

{
  "name": "grok_x_compete",
  "arguments": {
    "brands": ["Slack", "Microsoft Teams", "Discord"],
    "aspect": "enterprise features",
    "hours_back": 168
  }
}

🚨 grok_x_alerts — Webhook-Ready Monitoring

Get data formatted for automation tools.

Arguments:

Field	Type	Default	Description
alert_name	String	—	Name for this alert
query	String	—	Search query
sentiment_filter	String	any	Sentiment to match
min_engagement	Integer	0	Minimum engagement
alert_threshold	Integer	1	Trigger when this many found

Example:

{
  "name": "grok_x_alerts",
  "arguments": {
    "alert_name": "Competitor Complaints",
    "query": "hate @competitor",
    "sentiment_filter": "negative",
    "min_engagement": 5,
    "alert_threshold": 3
  }
}

grok_x_search — Raw X Search

Direct X/Twitter search without analysis.

Arguments:

Field	Type	Description
query	String	Search query
limit	Integer	Max results

grok_x_trends — Trending Topics

Get trending topics from X.

Arguments:

Field	Type	Description
category	String	Category: general, tech, business, sports, entertainment
limit	Integer	Max results

AI Chat & Analysis Tools

Tool	Description	Key Arguments
grok_chat	Chat with Grok	message
grok_news	Latest news on topic	topic, limit
grok_analyze	Summarize/critique content	content, analysis_type

Code Tools

Tool	Description	Key Arguments
grok_code_generate	Generate code	description, language
grok_code_review	Review for issues	code, focus
grok_code_fix	Fix broken code	code, error
grok_code_explain	Explain code	code

Utility Tools

Tool	Description
grok_stats	Get usage statistics

Output

Results are saved to the default dataset. Structure varies by tool.

Example output from grok_x_monitor:

{
  "type": "tool_result",
  "tool": "grok_x_monitor",
  "success": true,
  "result": {
    "query": "Acme Corp",
    "sentiment_summary": {
      "positive": 12,
      "negative": 3,
      "neutral": 5,
      "score": 0.45
    },
    "posts": [
      {
        "text": "Love the new Acme update!",
        "author": "@user123",
        "sentiment": "positive",
        "engagement": { "likes": 45, "retweets": 12 },
        "intent": "praise",
        "timestamp": "2025-01-15T10:30:00Z"
      }
    ],
    "themes": ["product update", "customer satisfaction"]
  },
  "timestamp": "2025-01-15T12:00:00Z"
}

Use Cases

Brand Health Dashboard

Run grok_x_monitor daily to track sentiment over time.

Sales Prospecting

Run grok_x_intent hourly to find high-intent leads.

Competitive Analysis

Run grok_x_compete monthly to identify positioning opportunities.

Crisis Detection

Run grok_x_alerts every 15 minutes with webhook integration.

Integrations

• Slack — Use grok_x_alerts output directly
• Zapier/Make — Webhook payload included in alerts
• CRM — Push leads from grok_x_intent to your pipeline
• Analytics — Track sentiment scores over time

Limitations

• X/Twitter tools require grok-4-fast or grok-4 model
• xAI API rate limits apply (see xAI documentation)
• Maximum 100 posts per search query
• Historical data limited to ~7 days for most queries

Getting Your API Key

1. Go to console.x.ai
2. Sign in with your X account
3. Create a new API key
4. Copy the key to the Actor input

The API is free until June 2025.

Support

Questions or issues? Open an issue on the Actor's page or contact the developer.

---

Signature: [Claude-Jaclyn]