# Grok — MCP server on mcp.ai
> Connect your Grok account and use 8 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Grok is xAI's API platform for text, image, video, embedding, file, search, and voice capabilities.

By: mcp.ai · official
Page: https://mcp.ai/grok

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_grok?ms=1787293620000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/grok/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/grok/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/grok/skill.md
Postman collection (v2.1): https://mcp.ai/grok/postman.json

## Tools
- grok_create_embeddings(user?: string, input: string|string[], model: string, dimensions?: integer, encoding_format?: string) — Create vector embeddings for one or more text inputs with an xAI embedding model.
- grok_create_response(input: string|object[], model: string, store?: boolean, tools?: object[], temperature?: number, tool_choice?: string|object, instructions?: string, reasoning_effort?: string, max_output_tokens?: integer, search_parameters?: object, previous_response_id?: string) — Generate a bounded, non-streaming Grok response from text or structured multimodal input, with optional reasoning, search, and function or web-search tools. Responses are ephemeral by default; set sto
- grok_generate_image(user?: string, model?: string, prompt: string, resolution?: string, image_count?: integer, aspect_ratio?: string, response_format?: string) — Generate one or more images from a text prompt with an xAI image-generation model.
- grok_generate_video(user?: string, model?: string, prompt: string, duration?: integer, image_url?: string, resolution?: string, aspect_ratio?: string) — Start asynchronous xAI video generation from a text prompt, optionally conditioned on an image, and return a request ID for status checks.
- grok_get_api_key_info() — Inspect the connected xAI API key's identity, wildcard or granular ACLs, and key or team blocking state.
- grok_get_current_account() — Verify the connected xAI credential and return the caller, team, zero-data-retention status, and key blocking state.
- grok_get_video(request_id: string) — Check an asynchronous xAI video request. Returns pending while generation is in progress, the video and usage when done, or the structured generation error when failed.
- grok_list_models() — List models available to the connected xAI key, including model IDs and published pricing metadata needed to choose a model for other tools.

## Example prompts
- "What can I do in Grok?"
- "Show me a summary of my Grok account"

## Links
Docs: https://mcp.ai/docs/mcps/grok
Website: https://mcp.ai/mcps/grok