How to Post to Twitter (X)
from Grok

export OPENTWEET_API_KEY="ot_your_key"
export XAI_API_KEY="xai-your_key"   # from the xAI console

import os, json, requests
from openai import OpenAI

# Grok API is OpenAI-compatible
grok = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")

OPENTWEET = "https://opentweet.io/api/v1/posts"
HEADERS = {"Authorization": f"Bearer {os.environ['OPENTWEET_API_KEY']}"}

def post_tweet(text: str, scheduled_date: str | None = None) -> dict:
    body = {"text": text}
    if scheduled_date:
        body["scheduled_date"] = scheduled_date   # ISO 8601, schedules it
    else:
        body["publish_now"] = True                # publish right away
    r = requests.post(OPENTWEET, headers=HEADERS, json=body, timeout=30)
    r.raise_for_status()
    return r.json()

tools = [{
    "type": "function",
    "function": {
        "name": "post_tweet",
        "description": "Post a tweet to the user's connected X account.",
        "parameters": {
            "type": "object",
            "properties": {
                "text": {"type": "string", "description": "Tweet text, max 280 chars"},
                "scheduled_date": {"type": "string", "description": "Optional ISO 8601 time to schedule"},
            },
            "required": ["text"],
        },
    },
}]

messages = [{"role": "user", "content": "Post a tweet announcing our v2 launch today."}]
resp = grok.chat.completions.create(model="grok-4", messages=messages, tools=tools)
msg = resp.choices[0].message

if msg.tool_calls:
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = post_tweet(**args)
        messages.append(msg)
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result),
        })
    # Let Grok confirm to the user
    final = grok.chat.completions.create(model="grok-4", messages=messages, tools=tools)
    print(final.choices[0].message.content)

mcp.opentweet.io/mcp

{
  "mcpServers": {
    "opentweet": {
      "type": "http",
      "url": "https://mcp.opentweet.io/mcp",
      "headers": { "Authorization": "Bearer ot_your_key" }
    }
  }
}