How to Tweet from the
OpenAI Agents SDK

pip install openai-agents requests

export OPENAI_API_KEY="sk-your_key"
export OPENTWEET_API_KEY="ot_your_key"

import os, requests
from agents import Agent, Runner, function_tool

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

@function_tool
def post_tweet(text: str, scheduled_date: str | None = None) -> str:
    """Post a tweet to the user's connected X account.

    Args:
        text: The tweet text, up to 280 characters.
        scheduled_date: Optional ISO 8601 time to schedule instead of posting now.
    """
    body = {"text": text}
    if scheduled_date:
        body["scheduled_date"] = scheduled_date
    else:
        body["publish_now"] = True
    r = requests.post(OPENTWEET, headers=HEADERS, json=body, timeout=30)
    r.raise_for_status()
    data = r.json()
    return f"Posted, status={data.get('status')}, id={data.get('id')}"

agent = Agent(
    name="X poster",
    instructions="You post to X when asked. Keep tweets under 280 characters.",
    tools=[post_tweet],
)

result = Runner.run_sync(agent, "Tweet: shipped the OpenAI Agents SDK integration today.")
print(result.final_output)

import os, asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="opentweet",
        params={
            "url": "https://mcp.opentweet.io/mcp",
            "headers": {"Authorization": f"Bearer {os.environ['OPENTWEET_API_KEY']}"},
        },
    ) as opentweet:
        agent = Agent(
            name="X poster",
            instructions="You post and schedule on X using the OpenTweet tools.",
            mcp_servers=[opentweet],
        )
        result = await Runner.run(agent, "Schedule a tweet for tomorrow 9am about our launch.")
        print(result.final_output)

asyncio.run(main())