/SKILL.md
# Grok API Skill Use the Grok API MCP server to search the web and get grounded answers from Grok (xAI). Prefer the Rust CLI in `cli/` for direct terminal use; use the MCP server when an MCP host specifically needs tools. ## When to Use - **Web search**: Current events, recent news, facts that need verification - **Grounded answers**: Questions needing authoritative sources - **Deep reasoning**: Complex problems requiring step-by-step analysis - **General chat**: Conversations without web sea
npx skillsauth add rrajasek95/grok-api-mcp grok-api-mcpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use the Grok API MCP server to search the web and get grounded answers from Grok (xAI). Prefer the Rust CLI in cli/ for direct terminal use; use the MCP server when an MCP host specifically needs tools.
search(query: str, max_results: int = 10)
Returns structured search results (title, URL, snippet).
ask(query: str, response_id: Optional[str] = None, max_tokens: int = 8192)
Returns a concise, factual answer with citations.
think(query: str, response_id: Optional[str] = None, max_tokens: int = 16384)
Returns thorough analysis with step-by-step reasoning.
chat(query: str, response_id: Optional[str] = None, max_tokens: int = 8192)
Chat without web search for creative tasks or general conversation.
x_search(
query: str,
max_results: int = 10,
allowed_handles: Optional[list[str]] = None,
excluded_handles: Optional[list[str]] = None,
from_date: Optional[str] = None,
to_date: Optional[str] = None,
enable_images: bool = False,
enable_video: bool = False,
)
Returns structured X search results with authors, posts, and URLs.
x_ask(
query: str,
response_id: Optional[str] = None,
max_tokens: int = 8192,
allowed_handles: Optional[list[str]] = None,
excluded_handles: Optional[list[str]] = None,
from_date: Optional[str] = None,
to_date: Optional[str] = None,
enable_images: bool = False,
enable_video: bool = False,
)
Returns an answer grounded in X posts, with follow-up support via response_id.
search("latest xAI announcements 2025")
ask("What is xAI and what is their mission?")
think("Compare the capabilities and architecture of Grok vs other AI models")
x_search("Latest xAI announcements", allowed_handles=["xai"])
x_ask("What are people saying about Grok?", from_date="2026-03-01")
# First question
ask("What is quantum computing?")
# Returns: ... response_id: resp_abc123
# Follow-up (Grok remembers context)
ask("How is it different from classical computing?", response_id="resp_abc123")
Responses include:
Requires XAI_API_KEY environment variable. Get your key from https://console.x.ai/
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.