Grok chat completions with X (Twitter) search grounding via MPP micropayments
What it does
This endpoint provides access to xAI's Grok models with built-in X (formerly Twitter) search capabilities, served through the Locus MPP (Micropayment Protocol) gateway. It accepts a standard chat-completions-style request body with a model parameter (Grok-4 family required, e.g. grok-4-0709, grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning), a messages array, and optional temperature and max_tokens controls. The model searches X posts in real time to ground its responses in current social-media content, making it useful for tracking breaking news, trending topics, public sentiment, and live event commentary as discussed on X.
The endpoint is part of a broader Grok service hosted at grok.mpp.paywithlocus.com that also exposes chat, web-search, code-execution, image-generation, image-editing, and text-to-speech paths. Payment is per-call via the Tempo method (pathUSD on Tempo L2), with dynamic pricing described as approximately $0.01–$0.50 per request depending on model and token usage. The OpenAPI spec lists the currency address as 0x20c000000000000000000000b9537d11c60e8b50.
Note: The probe did not capture a 402 challenge on HEAD or GET for this specific path (returned 404), which is expected since the endpoint only accepts POST. The OpenAPI schema is well-defined and the service infrastructure appears operational. Documentation references include https://docs.x.ai for the upstream xAI API and https://beta.paywithlocus.com/mpp/grok.md for Locus-specific integration details.
Capabilities
Use cases
- —Querying real-time X/Twitter posts to track breaking news or trending topics
- —Analyzing public sentiment on X about a brand, product, or event
- —Building agents that answer questions grounded in current social media discourse
- —Monitoring live event commentary and reactions on X
- —Retrieving recent X posts relevant to a research query with AI summarization
Fit
Best for
- —Agents needing real-time social media context from X/Twitter
- —Pay-per-call access to Grok models without an xAI API key
- —Applications requiring grounded, citation-backed answers from X posts
- —Developers who want micropayment-based access without subscriptions
Not for
- —General web search (use the /grok/web-search endpoint instead)
- —High-volume batch processing where per-call pricing may be expensive
- —Use cases requiring search across platforms other than X
Quick start
curl -X POST https://grok.mpp.paywithlocus.com/grok/x-search \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4-0709",
"messages": [
{"role": "user", "content": "What are people saying about the latest SpaceX launch on X?"}
],
"max_tokens": 1024
}'Example
Request
{
"model": "grok-4-0709",
"messages": [
{
"role": "user",
"content": "What are people saying about the latest SpaceX launch on X?"
}
],
"max_tokens": 1024,
"temperature": 0.7
}Endpoint
Quality
The OpenAPI schema is detailed with clear request schemas, model names, and pricing guidance. However, the probe did not capture a live 402 challenge on this specific endpoint (POST-only path probed with HEAD/GET), no example response schema is provided, and crawled pages all returned 404 with no additional documentation content. Pricing is described qualitatively but not as a fixed amount.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only; liveness not confirmed via 402 challenge
- —No response schema documented in the OpenAPI spec
- —Pricing is described as 'Dynamic (~$0.01–$0.50)' without exact per-token rates
- —No example response available from probe or crawl
- —External docs at https://beta.paywithlocus.com/mpp/grok.md and https://docs.x.ai were not crawled
Citations
- —Endpoint accepts Grok-4 family models (grok-4-0709, grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning) for X searchhttps://grok.mpp.paywithlocus.com
- —Payment is via Tempo method with dynamic pricing ~$0.01–$0.50https://grok.mpp.paywithlocus.com
- —Currency address is 0x20c000000000000000000000b9537d11c60e8b50 (pathUSD on Tempo L2)https://grok.mpp.paywithlocus.com
- —Upstream API reference at https://docs.x.ai and Locus-specific docs at https://beta.paywithlocus.com/mpp/grok.mdhttps://grok.mpp.paywithlocus.com