Home / Servers / X (Twitter) API / create_activity_subscription
Create X Activity Subscription
An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.
Create X Activity Subscription Creates a subscription for an X activity event. OAuth2 user-context tokens must hold the scope matching the requested event_type: dm.read for chat.* and dm.* events, like.read for like.* events… [POST /2/activity/subscriptions]
Name on the gateway: x_api__create_activity_subscription · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
event_type required | string | Activity event type in dot notation. chat.conversation_join is a deprecated… |
expires_at | string | Optional RFC 3339 expiration time. Re-creating the same subscription refreshes… |
filter required | object | Subscription filter. |
tag | string | Optional caller-defined tag. |
webhook_id | string | Webhook to deliver the subscription events to. |
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:
{
"name": "x_api__create_activity_subscription",
"arguments": {
"event_type": "…",
"filter": "…"
}
}Or connect the X (Twitter) API server directly, which lists 258 tools including this one:
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 x activity subscription tool with event_type set to ….