Home / Servers / X (Twitter) API / create_bot

Create a Bot

An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.

Create a Bot Creates a bot account in the calling app's project and returns its bearer token. Idempotent on handle: repeating the request for a handle that already names one of the project's bots returns that… [POST /2/bots]

Name on the gateway: x_api__create_bot · may change things.

Parameters

NameTypeDescription
display_namestringThe bot's display name; defaults to the handle.
handle requiredstringThe bot's handle (X screen name): 5-15 characters, letters, numbers, or…
org_onlybooleanWhether only members of the bot's developer account can add it to group chats.…
scopesarrayScopes for the bot's bearer token. Broadcast moderation additionally supports…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "x_api__create_bot",
  "arguments": {
    "handle": "…"
  }
}

Or connect the X (Twitter) API server directly, which lists 258 tools including this one:

Run in your terminal
claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a bot tool with display_name set to ….

More from X (Twitter) API