Hogmatix runs a remote Model Context Protocol (MCP) server at https://hogmatix.com/mcp. Assistants use it to read your connected X, TikTok and YouTube accounts and your queue, and to schedule or cancel posts for you, after you sign in on hogmatix.com and approve access.
Hogmatix is a social media scheduler. Its MCP server lets an assistant act on your Hogmatix account: list your connected X, TikTok and YouTube accounts, show your queue and your posting allowance, upload media, and schedule or cancel posts. You connect an assistant by adding the server URL and approving access on hogmatix.com, so you never give the assistant a password or an API key. A tool call never publishes anything by itself. Each post goes out at the time you chose, at least 10 minutes ahead, and can be canceled until then.
One endpoint for every client.https://hogmatix.com/mcp speaks Streamable HTTP. It accepts POST only, keeps no session, and answers with JSON.
OAuth 2.1 sign-in. The authorization code flow with PKCE (S256) and dynamic client registration. There are two scopes, hogmatix:read and hogmatix:schedule. Access tokens last 1 hour. Refresh tokens last 60 days and rotate on every use.
16 tools in total. Most clients see 14. Claude on the web, Desktop and mobile sees 11: it gets one-time upload links in place of the import and part-upload tools.
Scheduled, never immediate. The earliest time you can schedule is 10 minutes from now. A published post can't be deleted through the server; delete it on the platform.
X, TikTok and YouTube only. Instagram scheduling, connecting or disconnecting accounts, and billing stay on hogmatix.com.
The free plan works. Any verified, non-disposable email address gets 10 posts in any 30 days. A subscription allows 25 posts in any 24 hours. Videos without sound are refused on every platform.
Every client uses the same server URL and the same sign-in. The steps differ only in where you add the URL.
Server URL
https://hogmatix.com/mcp
Before you start
A Hogmatix account with a verified email address. Disposable (throwaway) addresses can't be used. The free plan works; a subscription raises your limits.
At least one X, TikTok or YouTube account connected on hogmatix.com. You connect and disconnect social accounts there, not in the assistant.
Table 1. Supported clients, how to add Hogmatix, and how each one handles photos and videos.
Client
Where it works
How to add it
Photos and videos
Tools
ChatGPT
Web, desktop and mobile apps
Install from ChatGPT's plugin directory
Attach the file in the chat
14
Claude
claude.ai, Claude Desktop, Claude mobile
Settings > Connectors
A one-time upload link on hogmatix.com
11
Claude Code
Terminal
claude mcp add
Uploads files from your computer
14
Codex
Codex CLI, Codex IDE extension, ChatGPT desktop app
codex mcp add, then codex mcp login
Uploads files from your computer
14
Grok
grok.com
Connectors > New Connector > Custom
Text posts only; schedule media on hogmatix.com
14
Other MCP clients
Any client with remote MCP and OAuth support
Add the server URL
Uploads files if the client can send HTTP PUT requests
Choose Install plugin. ChatGPT sends you to hogmatix.com. Sign in and choose Allow.
Ask, for example: “Show my connected social accounts and upcoming posts.”
To schedule a photo or video, attach it in the chat. Hogmatix copies it into its private storage first, which can take a moment for a large video. If an attachment from a ChatGPT mobile app doesn't come through, attach it again on the web.
Claude on the web, Desktop and mobile
In Claude on the web or in Claude Desktop, open Settings > Connectors.
If Hogmatix is listed in the directory, open it and choose Connect. Otherwise choose Add custom connector, name it Hogmatix and enter https://hogmatix.com/mcp.
Claude sends you to hogmatix.com. Sign in, check that the request returns to claude.ai, and choose Allow.
In a chat, turn Hogmatix on in the tools menu. A connector added on the web or in Claude Desktop is also available in the Claude mobile app.
Claude can't pass files you attach in the chat to Hogmatix. When you ask for a photo or video post, Claude gives you a one-time upload link on hogmatix.com. Open it, choose the file, wait until the page says Uploaded, then tell Claude. The full guide is at hogmatix.com/claude.
Claude Code
Terminal
claude mcp add --transport http hogmatix https://hogmatix.com/mcp
Then run /mcp in Claude Code, choose hogmatix and sign in on hogmatix.com. Claude Code returns to an address on your own computer, so the consent page names “a program on this computer”.
Sign in on hogmatix.com when Grok asks, and choose Allow. Allow pop-ups from grok.com if the sign-in window doesn't open.
From Grok you can schedule text posts on X and manage your queue. To post a photo or video, schedule it on hogmatix.com.
Any other MCP client
Any client that supports remote MCP servers over Streamable HTTP with OAuth can connect. Give it the server URL. It discovers the sign-in endpoints from the server's 401 response (see Authentication). A client that reads an mcpServers configuration can use:
The name of the transport field differs between clients (some expect "type": "http"), so check your client's documentation. To post photos or videos, the client must be able to send file bytes with HTTP PUT to a signed URL. A client that can't still schedules text posts on X.
First requests to try
“Which accounts do I have connected to Hogmatix?”
“Schedule an X post on my account for tomorrow at 9am Eastern: Our new release is out today.”
“What's scheduled on TikTok and YouTube this week?”
hogmatix.com is its own OAuth 2.1 authorization server. Clients sign users in with the authorization code flow and PKCE, and can register themselves with dynamic client registration. Tokens are issued only for the MCP endpoint. OpenID Connect is not supported.
The flow
The client calls POST /mcp without a token and gets 401 with a WWW-Authenticate header that points to the protected resource metadata.
It reads that metadata, which names https://hogmatix.com/ as the authorization server, then reads the authorization server metadata.
If it has no client ID yet, it registers at /register.
It opens /authorize in the browser with a PKCE code challenge.
Hogmatix sends the browser to its consent page. The user signs in if needed, reviews the request and chooses Allow or Cancel.
The browser returns to the client's redirect URI with code, state and iss.
The client exchanges the code and its code verifier at /token for an access token and a refresh token.
It calls /mcp with Authorization: Bearer and the access token, and refreshes the token when it expires.
redirect_uris is required. Each URI must use https, or http on localhost, 127.0.0.1 or [::1]. Custom schemes, fragments, and user names or passwords in the URI are refused.
For a loopback redirect URI, the port in the authorization request may differ from the registered port (RFC 8252). The scheme, host, path and query must match.
grant_types may contain only authorization_code and refresh_token, which is also the default. response_types is always code.
client_name is cut to 100 characters. The consent page shows it, with a warning that apps choose their own names.
A public client, such as a command-line or desktop app, registers with "token_endpoint_auth_method": "none" and relies on PKCE. Any other client receives a client_secret in the registration response, the only time it is shown. The secret does not expire. Send it with client_secret_post. HTTP Basic credentials are also accepted at /token and /revoke, though metadata doesn't advertise them.
A scope sent at registration is ignored. Scopes are chosen in each authorization request.
The request waits on the consent page for up to 15 minutes. After that the page shows “This sign-in request has expired” and “Go back to the app you were connecting and start again.”
Consent page
/authorize sends the browser to https://hogmatix.com/oauth/consent. The page:
asks the user to sign in with their Hogmatix email address and password if they aren't signed in;
shows the name the client registered, the host it returns to (or “a program on this computer” for a loopback address), the account that is signed in, and one line for each scope requested;
warns that apps choose their own names, and to allow access only when the user just started connecting this app;
offers Allow and Cancel.
Only a person signed in on hogmatix.com can approve a request; a token can't approve another client. Allow returns the browser to the client with code, state and iss=https://hogmatix.com/ (RFC 9207). Cancel returns error=access_denied with error_description=The user declined access.
Scopes
Table 4. Scopes, the exact text the consent page shows for each, and the tools each one unlocks.
Scope
Consent page text
Tools for most clients
Tools for hosted Claude
hogmatix:read
“See your connected X, TikTok and YouTube accounts, your scheduled posts and your plan”
A request without scope gets both scopes. An unknown scope is refused with invalid_scope and “Unsupported scope: …”.
The tool list follows the grant. A grant with only hogmatix:read sees only the read tools. Calling a tool outside the grant returns “Tool … not found”.
Neither scope can post immediately, connect or disconnect a social account, change billing, or reach Instagram. Uploads made with a token are limited to the purposes x-media, tiktok-video and youtube-video.
A refresh request may ask for fewer scopes than were granted, never more: “Cannot widen the granted scopes.”
Tokens
Table 5. What Hogmatix issues and how long each item lasts.
Item
Format
Lifetime
Notes
Authorization code
Opaque
10 minutes
Single use. Bound to the client, the redirect URI and the PKCE challenge.
Access token
hgxa_ and 43 characters
1 hour (expires_in: 3600)
Bearer token for /mcp. Opaque: don't parse it.
Refresh token
hgxr_ and 43 characters
60 days from issue
Rotates on every use. Each refresh returns a new pair and retires the old refresh token.
Client secret
Opaque
Does not expire
Confidential clients only.
Each refresh starts a new 60-day period, so a connection stays active as long as the client refreshes at least once every 60 days. Presenting a refresh token that was already rotated is treated as a stolen token: Hogmatix revokes the whole grant, and the user has to connect again. One exception covers a lost response. Within 120 seconds of a rotation, the previous refresh token is accepted once more, provided the token that replaced it was never used.
Exchange the code
POST /token HTTP/1.1
Host: hogmatix.com
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code&code=AUTHORIZATION_CODE&code_verifier=CODE_VERIFIER&client_id=CLIENT_ID&redirect_uri=http%3A%2F%2F127.0.0.1%3A8976%2Fcallback&resource=https%3A%2F%2Fhogmatix.com%2Fmcp
POST /token HTTP/1.1
Host: hogmatix.com
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=REFRESH_TOKEN&client_id=CLIENT_ID
Hogmatix also checks the account on every MCP request. If the account stops qualifying, for example because its email address is no longer verified, requests fail with 403 even while the token is valid.
Revocation
A client revokes access with POST /revoke, sending token (an access or refresh token) and its client credentials. Revoking any token of a grant ends the whole grant: its access tokens, its refresh token and any refresh tokens it already rotated.
As a user, you can end access in three ways:
Remove Hogmatix in the assistant's settings. Its access token stops working within an hour at most.
Reset your Hogmatix password. A reset disconnects every assistant connected to your account.
Email payme@ishti.org from your account's address, and we will revoke every assistant's access.
Rate limits on the OAuth endpoints
Table 6. Requests allowed from one IP address. Over the limit, the endpoint answers 429.
tools (with listChanged: true). No resources and no prompts.
Instructions
Sent in the initialize result. They tell the model to confirm the account, the exact text or caption, the time and every label with the user before scheduling, and how to upload media in that client. The full text is in the appendix.
Tool annotations
Every tool sets readOnlyHint, destructiveHint, idempotentHint and openWorldHint explicitly. execution.taskSupport is "forbidden".
Notifications
A POST that carries only notifications or responses gets 202 with no body.
How the tool list is chosen
The server picks a tool list from the redirect URIs the client registered. Claude's hosted apps can't hand a file to a tool or send bytes themselves, so they get upload links instead.
Table 8. Client variants.
Registered redirect URI
Variant
Tools
https://claude.ai/api/mcp/auth_callback or https://claude.com/api/mcp/auth_callback
Hosted Claude (web, Desktop, mobile)
11
https://chatgpt.com/connector_platform_oauth_redirect or https://chatgpt.com/connector/oauth/…
ChatGPT (same tools as default)
14
Any other URI, including Claude Code's loopback address
Default (Claude Code, Codex, Grok, other clients)
14
Calls that wait
Some tools wait for work to finish before they answer, so the model doesn't have to poll.
Table 9. Longest wait per tool.
Tool
Waits up to
While
get_import_status
About 20 seconds
The import is still downloading or uploading
get_upload_link_status
About 20 seconds
The user hasn't finished uploading
import_attached_file
About 40 seconds
The attachment is copied into storage
complete_media_upload
About 60 seconds
The upload is verified and made ready
Each tool call has a 90-second limit inside Hogmatix. Set your client's tool-call timeout to at least 90 seconds.
The server schedules to X, TikTok and YouTube. Instagram is supported on hogmatix.com but not through the MCP server.
Table 10. What an assistant can do on each platform through the MCP server.
Capability
X
TikTok
YouTube
Instagram
List connected accounts
Yes
Yes
Yes
No
List scheduled and recent posts
Yes, per account
Yes
Yes
No
Post immediately
No
No
No
No
Schedule (10 minutes or more ahead)
Yes
Yes
Yes
No (hogmatix.com only)
Text-only posts
Yes
No
No
No
Images
JPEG, PNG, WebP, GIF
No
No
No
Video
MP4, MOV
MP4, MOV, WebM
MP4, MOV, WebM
No
Media per post
One file
One video
One video
No
Threads
Yes
No
No
No
Long posts
Yes
No
No
No
Live account settings
No
Yes (get_tiktok_creator_info)
No
No
Cancel before publishing
Yes
Yes
Yes
No
Delete after publishing
No
No
No
No
Analytics
No
No
No
No
Connecting and disconnecting social accounts, billing, and Instagram scheduling happen on hogmatix.com.
On TikTok, every post choice is explicit, as TikTok's Direct Post rules require: privacy, comments, Duet, Stitch, commercial disclosure and the AI-generated label.
On YouTube, you set the title, description, privacy and made-for-kids setting. There is no separate Shorts setting.
The server has 16 tools. Most clients see 14 of them; hosted Claude sees 11. The table lists every tool, the scope it needs, which clients see it, and its annotations. Exact JSON schemas are in the appendix.
Table 11. All tools. “Default” covers ChatGPT, Claude Code, Codex, Grok and other clients.
Output. A successful call returns one text content item that holds pretty-printed JSON. A failed call returns isError: true with a plain-language message that says what to do next. HTTP status codes from Hogmatix are not passed through; only the message is.
Arguments. Unknown properties are ignored, so check spelling: a misspelled optional argument is dropped, not reported. A missing required argument, or one of the wrong type, returns a tool error that starts with “MCP error -32602: Input validation error”.
IDs. Uploads start with upl_, imports with imp_ and upload links with lnk_. Scheduled X text posts start with sp_; every post made from an upload starts with sub_.
Times.scheduledAt is ISO 8601 with a time-zone offset or Z, such as 2026-11-20T09:00:00-08:00, at least 10 minutes from now. Results return it in UTC, such as 2026-11-20T17:00:00.000Z.
Uploads are per platform. An upload is made for one purpose: x-media for X, tiktok-video for TikTok, youtube-video for YouTube. To post the same video on two platforms, upload it once for each.
Confirmation. The scheduling tools ask the model to confirm the account, the exact text or caption, the time and every label with the user before it calls them.
Typical sequences
Text post on X.list_accounts, then schedule_x_post.
Photo or video in ChatGPT.list_accounts, then import_attached_file for one platform (and get_import_status if it isn't ready yet), then that platform's schedule tool. Repeat per platform.
Photo or video in hosted Claude.create_upload_link, the user uploads the file on the link's page, then get_upload_link_status until state is ready, then the schedule tool with the returned uploadId.
Photo or video from a client that can send bytes (Claude Code, Codex). create_media_upload, then for each part get_upload_part_url and an HTTP PUT, then complete_media_upload, then the schedule tool.
TikTok. Call get_tiktok_creator_info first, let the user choose from its options, show them the required summary and declaration, and get their explicit go-ahead before schedule_tiktok_video.
Accounts, plan and queue
list_accountsreadall clientsList the X, TikTok and YouTube accounts connected to the user's Hogmatix account.
Returns the accounts the user connected on hogmatix.com. Call it first: the scheduling tools need an account's profile (X), openId (TikTok) or channelId (YouTube).
Parameters
Name
Type
Required
Notes
platform
string
No
One of x, tiktok, youtube. Lists only that platform. Omit to list all three.
Returns
An object with one key per platform requested. The X profile is the lowercase handle Hogmatix uses as the account key. needsReauth: true means the account must be connected again on hogmatix.com before it can post.
get_planreadall clientsShow the user's plan and how much of the posting allowance is used.
Reports the plan and the posting allowance. It does not offer subscriptions or change billing, and it does not report the usage allowance for X posting.
Parameters
None.
Returns
Field
Meaning
plan
premium (a subscription, including a trial) or free.
usage.used
Posts published in the current window.
usage.limit
Posts allowed in the window: 25 for premium, 10 for free.
usage.windowHours
Length of the rolling window: 24 for premium, 720 (30 days) for free.
usage.resetsAt
When the limit is reached, the time the next post becomes possible. Otherwise null.
get_tiktok_creator_inforeadall clientsRead a TikTok account's current posting options live from TikTok.
Reads the account's creator settings from TikTok at call time: who it posts as, the privacy levels it may use, its longest allowed video, and the interactions the creator turned off. It also returns the declaration TikTok requires the creator to see before posting. Call it before schedule_tiktok_video and let the user choose from these options.
Parameters
Name
Type
Required
Notes
openId
string
Yes
The TikTok account's openId from list_accounts. At least 1 character.
Returns
TikTok's fields creator_nickname, creator_username, privacy_level_options, comment_disabled, duet_disabled, stitch_disabled and max_video_post_duration_sec, plus postingAs, declaration and brandedContentDeclaration. When TikTok says the account can't post right now, the result has blocked: true with blockCode and blockReason, and no declaration; don't schedule.
{
"creator_nickname": "Your Name",
"creator_username": "yourname",
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"comment_disabled": false,
"duet_disabled": false,
"stitch_disabled": true,
"max_video_post_duration_sec": 600,
"postingAs": "Your Name (@yourname)",
"declaration": "By posting, you agree to TikTok's Music Usage Confirmation.",
"brandedContentDeclaration": "By posting, you agree to TikTok's Branded Content Policy and Music Usage Confirmation."
}
Errors
“Reconnect TikTok before refreshing creator information.” The account must be connected again on hogmatix.com.
list_scheduled_postsreadall clientsList scheduled and recent posts for one platform, with their status.
Lists the user's posts on one platform. Pending posts come first, soonest first; finished posts follow, newest first.
Parameters
Name
Type
Required
Notes
platform
string
Yes
One of x, tiktok, youtube.
profile
string
For X
X only: the profile from list_accounts.
Returns
{ "posts": [ … ] }. Each post has its id, scheduledAt, status and error, plus the platform's own fields: the text and format on X; the caption, privacy and disclosure choices on TikTok; the title, description and privacy on YouTube.
Platform
Status values
X
pending, posting, posted, failed. A post with media can also show the state of its upload, such as cancelled or failed-safe.
TikTok
pending, uploading, uploaded, cancelled, failed, or unknown: TikTok may have received the post, so check the profile before posting it again.
YouTube
pending, uploading, uploaded, or the state of its upload, such as cancelled or failed-safe.
Finished X text posts leave the list 7 days after they go out. Posts made from an upload stay listed for at least 90 days.
Media goes into Hogmatix's private storage before it is scheduled. There are three ways in, depending on the client. Each upload or import holds one of the account's 5 upload slots until it is scheduled.
get_upload_statusreadall clientsCheck a media upload's state. It is ready to schedule once the state is promoted.
Returns the upload record. state is promoted when the file is ready to schedule. Other states show progress (initiated, uploading, sealing, promoting) or an end (failed, aborted, expired); diagnostic explains a failure. For a video, audio reports the sound check (see Sound check).
import_attached_filewritesexcept hosted ClaudeCopy a file the user attached in a ChatGPT chat into Hogmatix's storage, for one platform.
ChatGPT fills in file with a signed link to the attachment (the tool declares it as a file parameter). Hogmatix downloads the file from ChatGPT's file hosts only, checks it against the platform's media rules, and stores it. The tool waits up to about 40 seconds. When state is ready, pass uploadId to the platform's schedule tool. If it is still downloading or uploading, call get_import_status.
Each platform needs its own import, so import for one platform, schedule that post, then import for the next. Calling again with the same attachment and purpose returns the same import until its upload has been scheduled. When the account's upload slots are full, the import fails and asks the user to schedule pending files first; it never deletes other files to make room. The tool is listed for every non-Claude client but works only in ChatGPT, because only ChatGPT's file hosts are accepted.
Parameters
Name
Type
Required
Notes
file
object
Yes
The attachment. ChatGPT fills this in.
file.download_url
string
Yes
ChatGPT's signed link. Only links on oaiusercontent.com and chatgpt.com are accepted.
file.file_id
string
Yes
ChatGPT's file ID.
file.mime_type
string
No
The file's media type.
file.file_name
string
No
The file's name.
purpose
string
Yes
One of x-media, tiktok-video, youtube-video.
Returns
The import. durationSec is a video's length in seconds, needed by schedule_tiktok_video; if it is null, ask the user. A failed import comes back as a tool error with error explaining why.
“The file argument was missing from this call. …” Call again with the attachment; if it is missing again, ask the user to attach the file again.
“The attached file arrived as a placeholder, not a file. …” or “… arrived without its download link.” Attach the file again in ChatGPT on the web, or upload it on hogmatix.com.
“That link is not from ChatGPT's file storage, so Hogmatix can't import it. …”
“The attachment link has expired. Attach the file again.”
Upload quota and media type errors (see Tool errors).
get_import_statusreadexcept hosted ClaudeCheck an import started by import_attached_file.
Waits up to about 20 seconds while the import is still downloading or uploading. When state is ready, schedule with uploadId. A failed import comes back as a tool error and says why in error.
Parameters
Name
Type
Required
Notes
importId
string
Yes
Pattern ^imp_[A-Za-z0-9_-]{1,128}$.
Returns
The same shape as import_attached_file: importId, state, filename, mimeType, byteSize, durationSec, and uploadId or error when present.
Errors
“Hogmatix no longer has this import: it expired or the server restarted. Call import_attached_file again with the same attachment.”
create_media_uploadwritesexcept hosted ClaudeStart a direct upload from a client that can send file bytes itself.
Starts an upload into private storage and returns the upload record with uploadId, partSize and partCount. Parts are 16 MiB (16,777,216 bytes) except the last, and are numbered from 1. For each part, call get_upload_part_url, then PUT the bytes. Finish with complete_media_upload. For a file attached in ChatGPT, use import_attached_file instead.
An unfinished upload expires after about 2 hours without activity. A finished upload that is never scheduled is cleared about a day later.
Parameters
Name
Type
Required
Notes
purpose
string
Yes
One of x-media, tiktok-video, youtube-video.
filename
string
Yes
1 to 200 characters.
mimeType
string
Yes
3 to 100 characters, such as video/mp4, video/quicktime or image/png. Must be allowed for the purpose (see Media types and sizes).
byteSize
integer
Yes
Greater than 0, and within the size limit for the type.
Returns
The upload record, as in get_upload_status, with stateinitiated.
Errors
“Too many active uploads. Finish or cancel one before starting another.”
“Your active upload byte limit would be exceeded.”, “Your daily upload count limit has been reached.” or “Your daily upload byte limit would be exceeded.”
“Upload capacity is temporarily full. Try again later.”
get_upload_part_urlwritesexcept hosted ClaudeRegister one part of an upload and get a short-lived signed URL to PUT it to.
Records the part's SHA-256 checksum on the upload and returns a signed URL that lives about 15 minutes. PUT exactly expectedSize bytes to url, with every header in headers. If a PUT fails, call again with the same checksum for a fresh URL. A different checksum for the same part is refused. Each call counts toward the upload's limit of 128 part URLs.
Parameters
Name
Type
Required
Notes
uploadId
string
Yes
Pattern ^upl_[A-Za-z0-9_-]{1,128}$.
partNumber
integer
Yes
1 or more, up to the upload's partCount.
checksumSha256
string
Yes
The base64 SHA-256 digest of the part's bytes (44 characters). The schema allows 40 to 64.
complete_media_uploadwritesexcept hosted ClaudeFinish an upload after every part was sent, and wait for it to be ready.
Verifies every part and the file type, and waits up to about a minute for the upload to reach promoted. If a part's size or checksum, or the file's type, fails verification, the upload is marked failed and must be started again. If parts are missing, PUT them and call this again. A video's sound is measured at this step.
create_upload_linkwriteshosted Claude onlyCreate a one-time link to a hogmatix.com page where the user uploads a file for one platform.
Hosted Claude can't pass chat attachments to a tool, so it gives the user a link instead. The user opens url in a browser, chooses a photo or video, and the page uploads it to Hogmatix's private storage. The link takes one file. It expires after 30 minutes if unused; once an upload starts, it has 2 hours to finish. An account can have 5 unused links at once. accepts lists the file types and sizes the purpose takes.
get_upload_link_statusreadhosted Claude onlyCheck an upload link and get the uploadId once the file is ready.
Waits up to about 20 seconds while the user hasn't finished uploading. Listed for a grant with either scope, so a grant that can create links can always learn the uploadId they produce.
state
Meaning
waiting
The page wasn't opened, or no file was chosen yet.
uploading
The file is on its way.
ready
Schedule with uploadId.
failed
error says why. Create a new link.
expired
The link wasn't used within 30 minutes.
Parameters
Name
Type
Required
Notes
linkId
string
Yes
Pattern ^lnk_[A-Za-z0-9_-]{22}$.
Returns
When ready, durationSec is a video's length in seconds for schedule_tiktok_video. It is null when the browser couldn't read it; then ask the user. For a video, audio reports the sound check.
These tools change what will appear publicly, so they are marked destructive. Nothing is published when they run: the post goes out at scheduledAt.
schedule_x_postwritesall clientsSchedule a post, thread or long post on a connected X account.
At the scheduled time Hogmatix publishes the post on X, where it is public. Hogmatix never deletes published posts from X; until publishing, cancel_scheduled_post can cancel it. For a thread, separate the posts with a blank line. Optionally attach one file uploaded with purpose x-media. Confirm the account, the exact text and the time with the user first.
Retrying is safe. The same account, text, format, time and upload always produce the same request, so a retry after a lost response returns the post already queued instead of a second post.
Parameters
Name
Type
Required
Notes
profile
string
Yes
The X profile from list_accounts. At least 1 character.
text
string
Yes
1 to 25,000 characters. For a thread, separate the posts with a blank line.
format
string
No
One of shortform, thread, longform. Default shortform. See X rules.
scheduledAt
string
Yes
ISO 8601 with a time-zone offset, at least 10 minutes ahead.
uploadId
string
No
A ready upload with purpose x-media. Pattern ^upl_[A-Za-z0-9_-]{1,128}$.
Returns
id starts with sp_ for a text post and sub_ for a post with media. costNote appears only when the text contains a link, and says what X posting will do with it.
{
"scheduled": true,
"id": "sp_1763650800000_k3j9x",
"scheduledAt": "2026-11-20T17:00:00.000Z",
"profile": "yourhandle",
"format": "shortform",
"costNote": "Contains a link: links are removed before posting to X."
}
“Long posts with links can't be sent to X. Remove the link and try again.”
A usage allowance message, such as “The free plan's monthly usage allowance is used up. More becomes available on 2026-12-01.”
For media: the upload, sound check and claim errors in Tool errors.
Example call
{
"name": "schedule_x_post",
"arguments": {
"profile": "yourhandle",
"text": "Our new release is out today.",
"format": "shortform",
"scheduledAt": "2026-11-20T09:00:00-08:00"
}
}
schedule_tiktok_videowritesall clientsSchedule an uploaded video on a connected TikTok account, with every Direct Post choice explicit.
At the scheduled time Hogmatix publishes the video on TikTok. Hogmatix can't remove a published video; until publishing, cancel_scheduled_post can cancel it. Every choice is explicit, as TikTok's Direct Post rules require. Hogmatix checks the creator's settings and its posting-density rules when you schedule, and checks the settings again before publishing.
Before calling, show the user: “Posting as” with postingAs from get_tiktok_creator_info; the caption and time; the chosen privacy option; the comment, Duet and Stitch settings; the disclosure and AI-generated choices; and the declaration “By posting, you agree to TikTok's Music Usage Confirmation.” (with branded content: “By posting, you agree to TikTok's Branded Content Policy and Music Usage Confirmation.”). Then get the user's explicit go-ahead, even when the request already states every choice.
Parameters
All parameters are required.
Name
Type
Required
Notes
openId
string
Yes
The TikTok account's openId from list_accounts.
uploadId
string
Yes
A ready upload with purpose tiktok-video.
caption
string
Yes
Up to 2,200 characters. May be empty.
scheduledAt
string
Yes
ISO 8601 with a time-zone offset, at least 10 minutes ahead.
privacyLevel
string
Yes
One of PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY, and it must be in the account's privacy_level_options.
aiGenerated
boolean
Yes
Whether TikTok shows its AI-generated label on the video. Required by TikTok.
yourBrand
boolean
Yes
Commercial disclosure: the video promotes the creator's own business. Required when the caption mentions the account's own handle.
brandedContent
boolean
Yes
Commercial disclosure: paid promotion of a third party. Only with PUBLIC_TO_EVERYONE or MUTUAL_FOLLOW_FRIENDS.
allowComments
boolean
Yes
Stays off if the creator disabled comments.
allowDuet
boolean
Yes
Stays off if the creator disabled Duet.
allowStitch
boolean
Yes
Stays off if the creator disabled Stitch.
durationSec
number
Yes
The video's length in seconds, greater than 0. import_attached_file and get_upload_link_status return it. Rounded up, it must not exceed max_video_post_duration_sec.
“Branded content can't be private: choose PUBLIC_TO_EVERYONE or MUTUAL_FOLLOW_FRIENDS.”
“That privacy setting is no longer available for this TikTok account. Choose one of the current options.”
“TikTok allows up to 600s for this account; this video is 720s.” (with the account's numbers)
“This caption mentions @yourname. Turn on Disclose video content and choose Your brand.” Set yourBrand to true.
“This account already has a TikTok post within 2 hours of that time. Pick a later time.”
“This would put 4 TikTok posts for this account inside one 24-hour window. The limit is 3. Pick a later time. Posts made in the TikTok app are not counted.”
“TikTok needs this account connected again before it can post. Reconnect to re-authorize.”
The scheduledAt, upload, sound check and claim errors in Tool errors.
schedule_youtube_videowritesall clientsSchedule an uploaded video on a connected YouTube channel.
At the scheduled time Hogmatix uploads the video to YouTube with the privacy you chose. Hogmatix can't remove an uploaded video; until then, cancel_scheduled_post can cancel it. Confirm the channel, the title, the privacy and the time with the user first. Videos are uploaded in YouTube category 22 (People & Blogs) with no tags.
Parameters
Name
Type
Required
Notes
channelId
string
Yes
The channel's channelId from list_accounts.
uploadId
string
Yes
A ready upload with purpose youtube-video.
title
string
Yes
1 to 100 characters.
description
string
No
Up to 5,000 characters. Default empty.
privacyStatus
string
Yes
One of private, unlisted, public.
madeForKids
boolean
Yes
YouTube's made-for-kids declaration.
scheduledAt
string
Yes
ISO 8601 with a time-zone offset, at least 10 minutes ahead.
The scheduledAt, upload, sound check and claim errors in Tool errors.
Example call
{
"name": "schedule_youtube_video",
"arguments": {
"channelId": "UCexample",
"uploadId": "upl_example456",
"title": "Behind the scenes",
"description": "How we built this release.",
"privacyStatus": "unlisted",
"madeForKids": false,
"scheduledAt": "2026-11-21T12:00:00-08:00"
}
}
cancel_scheduled_postwritesall clientsCancel a post that has not been published yet.
Canceling is permanent. The post can't be restored, and posting it later means scheduling a new post, with its media imported or uploaded again. Posts already on X, TikTok or YouTube can't be recalled here.
Parameters
Name
Type
Required
Notes
platform
string
Yes
One of x, tiktok, youtube.
id
string
Yes
The id from list_scheduled_posts or the schedule result. Pattern ^[A-Za-z0-9_-]{1,128}$. TikTok and YouTube IDs start with sub_.
These limits apply to every client. They are the same limits Hogmatix applies on hogmatix.com, because every tool works through Hogmatix's own API with the user's token.
Plans and posting allowance
Table 12. Plans and how many posts each allows. Counts cover all platforms together.
Plan
Who gets it
Posts
Rolling window
Free
Any account with a verified email address that isn't a disposable address
10
30 days
Trial
First-time subscribers, for seven days
25
24 hours
Subscription (US$20 a month)
Subscribers
25
24 hours
A post counts when it is published, not when it is scheduled. An X thread counts as one post. A post that would go over the allowance is not published; it fails safely and its error in list_scheduled_posts says when posting resumes, for example “Fair-use limit reached: 25 posts in the last 24 hours. Posting resumes at 2026-11-13 09:00 UTC.” or “Free plan limit reached: 10 posts in 30 days. …”.
get_plan shows the plan, the posts used and when the next post becomes possible.
An account that no longer qualifies (an unverified or disposable address, or a deleted account) can't use the server: requests fail with 403.
Usage allowance for X posting
Posting to X uses X's paid API, so X posts draw on a monthly usage allowance. TikTok and YouTube scheduling do not.
Each plan includes an allowance that covers ordinary scheduling; a larger plan includes more. Every part of a thread counts as one post. Links are removed from X posts before posting, so a post never counts at X's higher rate for links.
The allowance is checked when an X post is scheduled and again when it is published. When it is used up, schedule_x_post fails with, for example, “Your plan's monthly usage allowance is used up. More becomes available on 2026-12-01.”
ISO 8601 with seconds optional and a time-zone offset or Z: YYYY-MM-DDTHH:MM[:SS[.fff]](Z|±HH:MM)
Post immediately
Not available through the MCP server
TikTok post that starts late
Not posted if more than 6 hours late. Schedule it again.
X text posts in the list
Kept 7 days after they finish
Posts from uploads in the list
Kept at least 90 days after they finish
Media types and sizes
Table 14. Accepted types and maximum sizes per upload purpose. 1 MiB is 1,048,576 bytes.
Purpose
Platform
Type
Media type
Maximum
x-media
X
JPEG
image/jpeg
5 MiB
PNG
image/png
5 MiB
WebP
image/webp
5 MiB
GIF
image/gif
15 MiB
MP4
video/mp4
512 MiB
MOV
video/quicktime
512 MiB
tiktok-video
TikTok
MP4
video/mp4
512 MiB
MOV
video/quicktime
512 MiB
WebM
video/webm
512 MiB
youtube-video
YouTube
MP4
video/mp4
512 MiB
MOV
video/quicktime
512 MiB
WebM
video/webm
512 MiB
The file's bytes must match its declared type. Otherwise the upload fails with “The uploaded bytes do not match the declared media type …”.
Upload quotas
Table 15. Per-account limits on uploads and imports.
Limit
Value
Active upload slots
5 per account. An upload or import holds a slot from the moment it starts until it is scheduled.
Bytes in active uploads
1 GiB per account
New uploads
20 per rolling 24 hours, and 2 GiB per rolling 24 hours
Part size
16 MiB (the last part may be smaller)
Part URLs
128 per upload; each lives about 15 minutes
Finishing attempts
10 per upload
Unfinished upload
Expires after about 2 hours without activity
Finished upload never scheduled
Cleared about a day later
Upload links (hosted Claude)
Table 16. Limits on links from create_upload_link.
Limit
Value
Time to open and start
30 minutes
Time to finish after starting
2 hours
Files per link
1
Unused links per account
5
Chat imports (ChatGPT)
Table 17. Limits on import_attached_file.
Limit
Value
Accepted hosts
oaiusercontent.com, chatgpt.com
Imports running at once
2 per account
Imports per day
20 per account, and 2 GiB per account
Download deadline
10 minutes
Storing deadline
30 minutes
Import status
Kept about a day. A server restart loses it; import the attachment again.
X rules
Table 18. What happens to each X format at publishing time.
Format
How it posts
Links
Media
shortform
One post. Line breaks and repeated spaces become single spaces, em and en dashes become hyphens, and a quote mark at the very start or end is removed.
Removed before posting. A bare domain keeps its name: “OpenAI.com” becomes “OpenAI”.
One file
thread
Split on blank lines; each part replies to the one before.
A part that contains a link is skipped.
On the first part only
longform
One long post with its line breaks kept.
Refused when you schedule: “Long posts with links can't be sent to X. Remove the link and try again.”
One file
Text may be up to 25,000 characters. Hogmatix doesn't check the 280-character limit that X applies to accounts without X Premium, so keep short posts within it for those accounts.
When the text contains a link, the schedule result carries a costNote: “Contains a link: links are removed before posting to X.”, “Contains a link: thread posts with a link are skipped when posting to X.” or “Contains a link: long posts with links are refused when posting to X; remove it.”
TikTok rules
Captions may be up to 2,200 characters.
The AI-generated label, commercial disclosure and each interaction are explicit choices with no defaults.
The privacy level must be one of the account's current privacy_level_options.
The video's length must be within max_video_post_duration_sec.
If the caption mentions the account's own handle, yourBrand must be true.
Branded content requires PUBLIC_TO_EVERYONE or MUTUAL_FOLLOW_FRIENDS.
Interactions the creator turned off in TikTok stay off.
At most 3 posts per TikTok account in any 24 hours, and at least 2 hours apart. Posts made in the TikTok app are not counted.
A post that would start more than 6 hours late is not posted.
An account marked needsReauth must be connected again on hogmatix.com.
YouTube rules
Titles are 1 to 100 characters; descriptions up to 5,000.
Privacy is private, unlisted or public, and the made-for-kids declaration is required.
Videos go into category 22 (People & Blogs) with no tags. There is no Shorts setting.
Sound check: videos without sound are refused
Hogmatix doesn't post videos without sound, on any platform. A video with no audio track, or one whose mean volume is below -50 dB, is refused. So is a video the check couldn't measure. There is no override through the MCP server. Photos are never checked.
Each video is measured when its upload finishes, again when it is scheduled, and again right before publishing. get_upload_status and get_upload_link_status show the result in audio.verdict, so the model can warn the user before scheduling.
Table 19. Sound check verdicts.
audio.verdict
Meaning
Result
ok
The video has sound at a normal level.
Can be scheduled
no-sound
No audio track.
Refused. Add a soundtrack and upload again.
silent
Mean volume below -50 dB.
Refused. Fix the audio and upload again.
check-failed
The check couldn't run.
Refused until the check works. Try again shortly.
not-checked
Not measured yet.
Measured when the post is scheduled
Canceling and deleting
Only posts that haven't been published can be canceled. An X text post must still be pending.
Canceling is permanent. An upload whose post was canceled can't be scheduled again; upload or import the file again.
An upload can be scheduled once per platform. Scheduling it again with the same settings returns the existing post; with different settings it fails with “This upload was already claimed with different submission settings.”
Published posts can't be deleted through the MCP server. Delete them on X, TikTok or YouTube.
Errors arrive at three levels: HTTP responses from /mcp (before any tool runs), OAuth errors during sign-in, and tool errors (isError: true) from a tool call.
HTTP and JSON-RPC errors from /mcp
Table 20. Responses from the endpoint itself.
HTTP
Code
Message
What to do
401
invalid_token
“Missing Authorization header”, “Invalid access token.” or “Invalid or expired access token.”
Refresh the token, or sign in again.
403
-32001
“Your Hogmatix account is not active.”
Verify your email address on hogmatix.com with a non-disposable address, or subscribe, then connect again.
503
-32002
“Hogmatix could not check your account right now.”
Try again in a moment.
405
-32000
“Method not allowed.”
Use POST.
406
-32000
“Not Acceptable: Client must accept both application/json and text/event-stream”
Send Accept: application/json, text/event-stream.
415
-32000
“Unsupported Media Type: Content-Type must be application/json”
Send Content-Type: application/json.
400
-32000
“Bad Request: Unsupported protocol version: …”
Use a supported protocol version.
500
-32603
“Internal server error”
Try again. If it persists, contact support.
OAuth errors
Table 21. Errors during registration, authorization and token requests.
Code
Message
Cause
invalid_client_metadata
“redirect_uris must be https URLs or http loopback URLs.”
A redirect URI that isn't https or a loopback http address.
invalid_client_metadata
“Only the authorization_code and refresh_token grants are supported.”
Another grant type in the registration.
invalid_client_metadata
“Client registration is temporarily unavailable.”
Registration is closed for now. Try again later.
invalid_scope
“Unsupported scope: …”
A scope other than hogmatix:read or hogmatix:schedule.
invalid_target
“This authorization server only issues tokens for the Hogmatix MCP endpoint.”
A resource other than https://hogmatix.com/mcp.
access_denied
“The user declined access.”
The user chose Cancel on the consent page.
invalid_grant
“Invalid or expired authorization code.”
The code was used, expired after 10 minutes, or belongs to another client.
invalid_grant
“redirect_uri does not match the authorization request.”
A different redirect_uri at /token.
invalid_grant
“Invalid refresh token.”
Expired, revoked or already rotated. Sign in again.
invalid_scope
“Cannot widen the granted scopes.”
A refresh asked for a scope the grant doesn't have.
Consent page
“This sign-in request has expired” and “Go back to the app you were connecting and start again.”
More than 15 minutes passed, or the request was already answered.
A tool error is a normal result with isError: true and one text item. The text is Hogmatix's message, “Hogmatix returned status.” when there is none, or “Hogmatix could not complete that request.”
Table 22. Tool error messages users see most, grouped by area.
The tool isn't in this grant's list. Reconnect with the needed scope.
Time
“scheduledAt must be ISO 8601 with a time-zone offset, e.g. 2026-10-01T16:05:00-07:00.”
Add the offset or Z.
“scheduledAt is not a valid date.”
Check the date.
“scheduledAt must be at least 10 minutes from now.”
Pick a later time.
Allowances
“Your plan's monthly usage allowance is used up. More becomes available on …” (also free and trial versions)
Wait for the date, or schedule on TikTok and YouTube, which don't use it.
Uploads, imports and links
“Too many active uploads. Finish or cancel one before starting another.”
Schedule a pending upload first, or wait for unused ones to clear.
“Your daily upload count limit has been reached.” / “Your daily upload byte limit would be exceeded.” / “Your active upload byte limit would be exceeded.”
Wait, or schedule pending uploads.
“Upload capacity is temporarily full. Try again later.”
Retry later.
“The uploaded bytes do not match the declared media type …”
Declare the file's real type and upload again.
“Upload stopped in state …: …”
Start a new upload.
“Hogmatix no longer has this import: it expired or the server restarted. …”
Call import_attached_file again.
“That link is not from ChatGPT's file storage, so Hogmatix can't import it. …”
Attach the file in ChatGPT, or upload on hogmatix.com.
“The attachment link has expired. Attach the file again.”
Attach it again.
“This account already has 5 unused upload links. …”
Use a link, or wait up to 30 minutes.
“Hogmatix has no such upload link for this account. …”
Create a new link.
Sound check
“… has no sound: ffprobe found no audio track. …”
Add a soundtrack and upload again.
“… is effectively silent: …”
Fix the audio and upload again.
“… was not posted because Hogmatix could not check its sound. …”
Try again shortly.
Scheduling
“This upload was already claimed with different submission settings.”
Upload the file again for a different post.
“The existing submission is cancelled; check submission history before uploading new media.”
Upload the file again and schedule a new post.
“Long posts with links can't be sent to X. Remove the link and try again.”
Remove the link, or use shortform.
“Branded content can't be private: …”
Choose public or friends visibility.
“That privacy setting is no longer available for this TikTok account. …”
Call get_tiktok_creator_info and choose again.
“This account already has a TikTok post within 2 hours of that time. Pick a later time.”
Move the post.
“This would put … TikTok posts for this account inside one 24-hour window. …”
Move the post to a later day.
“TikTok needs this account connected again before it can post. …”
Reconnect the account on hogmatix.com.
“Could not check this TikTok account's current settings, so nothing was posted. Try again. …”
Retry.
Canceling
“Only pending posts can be cancelled.” / “Only a submission that has not started provider work can be cancelled.”
The post is already going out or finished.
“profile is required for X.”
Pass profile to list_scheduled_posts.
Some failures happen at publishing time rather than when a tool runs. They show in the post's error field in list_scheduled_posts, for example a posting allowance message, “This post missed its scheduled time by more than 6 hours, so it was not posted. Schedule it again.” or “Held back: another post for this TikTok account went out less than 2 hours ago. Reschedule it.”
No passwords or API keys in the assistant. Users sign in on hogmatix.com, and only a person signed in there can approve a client. Tokens are issued only for https://hogmatix.com/mcp.
Tokens are stored as hashes. Hogmatix keeps only a SHA-256 hash of each access token, refresh token and client secret. Access tokens last an hour; refresh tokens rotate on every use, and reuse of a rotated one revokes the grant.
Every call is checked like a web request. Tools call Hogmatix's own API with the user's token, so the same scope limits, account ownership checks and plan rules apply. The account itself is checked again on every request.
Media stays private. Uploads go to private storage, never to a public URL, and are posted only when a post the user confirmed is due. An upload that is never scheduled is cleared about a day later. Upload links carry their secret in the URL fragment, which browsers don't send to servers.
Imports fetch only from ChatGPT.import_attached_file downloads only from ChatGPT's file hosts and refuses links to private network addresses.
What an assistant receives
An assistant receives only the results of the calls it makes for you. Depending on the call, that can include your connected X, TikTok and YouTube account names and identifiers (listing your accounts can return all of them, even when you ask about one platform), your scheduled and recent posts with their text, media details, times and status, your TikTok account's current posting options, media upload status, and your plan and posting usage. The assistant's provider handles this under its own privacy policy. Details are in the Privacy Policy.
Ending access
Remove Hogmatix in the assistant's settings, reset your Hogmatix password, or email payme@ishti.org to have every assistant's access revoked. See Revocation.
Never send passwords, access tokens or card numbers to support. Hogmatix will never ask for them.
Each entry is the tool exactly as tools/list returns it, including the description the model reads. The default and ChatGPT lists share these definitions. Hosted Claude uses the same definitions for its tools, with one difference: in schedule_tiktok_video, the durationSec description reads “The video's length in seconds. get_upload_link_status returns it as durationSec.”
Server instructions: Default and ChatGPTThe instructions field of the initialize result.
Hogmatix schedules posts to the user's connected X, TikTok and YouTube accounts. Posts go out on the user's X, TikTok or YouTube account at the scheduled time, with the visibility the user picks, and can't be undone once published: confirm the account, the exact text or caption, the time and every label with the user before scheduling. For a file the user attached in the chat, call import_attached_file for one platform and schedule that platform's post with the uploadId it returns before importing for the next platform: an import holds upload storage until it is scheduled. A client that can PUT bytes itself uploads in three steps instead: create_media_upload, then PUT each part to the URL from get_upload_part_url, then complete_media_upload. Accounts are connected on https://hogmatix.com, not through these tools.
Server instructions: Hosted ClaudeThe instructions field of the initialize result.
Hogmatix schedules posts to the user's connected X, TikTok and YouTube accounts. Posts go out on the user's X, TikTok or YouTube account at the scheduled time, with the visibility the user picks, and can't be undone once published: confirm the account, the exact text or caption, the time and every label with the user before scheduling. Files attached in this chat can't be passed to Hogmatix. To post a photo or video, call create_upload_link for the platform and give the user the link: they choose the file on a hogmatix.com page, and get_upload_link_status reports when it is ready and returns the uploadId to schedule with. Each platform needs its own upload, and each upload holds upload storage until it is scheduled. Accounts are connected on https://hogmatix.com, not through these tools.
{
"name": "list_accounts",
"title": "List connected accounts",
"description": "List the X, TikTok and YouTube accounts connected to the user's Hogmatix. Call this first: the scheduling tools need an account's profile, openId or channelId. When the request is about one platform, pass platform to list only that platform's accounts.",
"inputSchema": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"x",
"tiktok",
"youtube"
],
"description": "List only this platform's accounts. Omit to list all three."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
get_planFull tools/list entry (default list).
{
"name": "get_plan",
"title": "Get plan and posting usage",
"description": "Show the signed-in user's Hogmatix plan and posting allowance. This tool does not offer subscriptions or change billing.",
"inputSchema": {
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "get_tiktok_creator_info",
"title": "Get TikTok posting options",
"description": "Read a connected TikTok account's current creator settings live from TikTok: who it posts as, the privacy levels it may post with, its maximum video length and interactions the creator disabled, plus the declaration TikTok requires the creator to see before posting. Call before schedule_tiktok_video and let the user choose from these options.",
"inputSchema": {
"type": "object",
"properties": {
"openId": {
"type": "string",
"minLength": 1,
"description": "The TikTok account's openId from list_accounts."
}
},
"required": [
"openId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "import_attached_file",
"title": "Import an attached file",
"description": "Import a video or image the user attached in this chat into Hogmatix's private storage so it can be scheduled. ChatGPT passes the attachment in file automatically; nothing else is fetched. Use purpose x-media for X, tiktok-video for TikTok or youtube-video for YouTube: each platform needs its own import of the attachment. Each import holds one of the account's upload slots until it is scheduled, so import only for platforms the user chose, and schedule each platform's post before importing for the next. Waits up to about 40 seconds. When state is \"ready\", pass uploadId to schedule_x_post, schedule_tiktok_video (with durationSec, the video's length in seconds; if it is null, ask the user) or schedule_youtube_video. If it is still \"downloading\" or \"uploading\", call get_import_status with importId. Calling again with the same attachment and purpose returns the same import until its upload has been scheduled, then imports it afresh. When the account's upload slots are full, the import fails and asks the user to schedule pending files first; it never deletes other files to make room.",
"inputSchema": {
"type": "object",
"properties": {
"file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "ChatGPT's signed link to the attachment. Only links on ChatGPT's file hosts (oaiusercontent.com, chatgpt.com) are accepted."
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false,
"description": "The file the user attached in the chat. ChatGPT fills this in."
},
"purpose": {
"type": "string",
"enum": [
"x-media",
"tiktok-video",
"youtube-video"
],
"description": "x-media for X, tiktok-video for TikTok, youtube-video for YouTube."
}
},
"required": [
"file",
"purpose"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"openai/fileParams": [
"file"
]
}
}
{
"name": "get_import_status",
"title": "Get import status",
"description": "Check an import started by import_attached_file. Waits up to about 20 seconds while it is still \"downloading\" or \"uploading\". When state is \"ready\", schedule with uploadId; durationSec is the video's length in seconds for schedule_tiktok_video. A \"failed\" import says why in error.",
"inputSchema": {
"type": "object",
"properties": {
"importId": {
"type": "string",
"pattern": "^imp_[A-Za-z0-9_-]{1,128}$"
}
},
"required": [
"importId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "create_media_upload",
"title": "Start a media upload",
"description": "Start uploading a video or image to Hogmatix's private storage, from a client that can PUT file bytes itself. For a file the user attached in the chat, use import_attached_file instead. Returns an uploadId, partSize and partCount. For each part (numbered from 1), call get_upload_part_url with the part's SHA-256 (base64), PUT exactly those bytes to the returned URL with the returned headers, then call complete_media_upload. Use purpose x-media for X images or video, tiktok-video for TikTok, youtube-video for YouTube. Each upload holds one of the account's upload slots until it is scheduled; an unfinished upload expires after about 2 hours without activity, and a finished one that is never scheduled is cleared about a day later.",
"inputSchema": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"enum": [
"x-media",
"tiktok-video",
"youtube-video"
]
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"mimeType": {
"type": "string",
"minLength": 3,
"maxLength": 100,
"description": "For example video/mp4, video/quicktime, image/png."
},
"byteSize": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"purpose",
"filename",
"mimeType",
"byteSize"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "get_upload_part_url",
"title": "Register an upload part",
"description": "Register one part of a media upload and get a short-lived signed URL for it. This records the part's SHA-256 checksum on the upload, marks the upload as uploading and counts toward the upload's part-URL limit. PUT exactly expectedSize bytes to url with the returned headers. If a PUT fails, call again with the same checksum for a fresh URL; a different checksum for the same part is refused.",
"inputSchema": {
"type": "object",
"properties": {
"uploadId": {
"type": "string",
"pattern": "^upl_[A-Za-z0-9_-]{1,128}$"
},
"partNumber": {
"type": "integer",
"minimum": 1
},
"checksumSha256": {
"type": "string",
"minLength": 40,
"maxLength": 64,
"description": "Base64 SHA-256 of the part's bytes."
}
},
"required": [
"uploadId",
"partNumber",
"checksumSha256"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "complete_media_upload",
"title": "Finish a media upload",
"description": "Finish a media upload after every part was PUT. Waits up to a minute for it to be ready (state \"promoted\"). If a part's size or checksum, or the file's type, fails verification, the upload is marked failed and must be started again; if parts are missing, PUT them and call this again.",
"inputSchema": {
"type": "object",
"properties": {
"uploadId": {
"type": "string",
"pattern": "^upl_[A-Za-z0-9_-]{1,128}$"
}
},
"required": [
"uploadId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
create_upload_linkFull tools/list entry (hosted Claude list).
{
"name": "create_upload_link",
"title": "Create an upload link",
"description": "Create a one-time link to a hogmatix.com page where the user chooses a photo or video on their device and uploads it to Hogmatix's private storage, for one platform. Use purpose x-media for X (images or video), tiktok-video for TikTok or youtube-video for YouTube; accepts lists the file types and sizes that purpose takes. The link takes one file and expires after 30 minutes if unused, and an account can have 5 unused links at once. Returns linkId and url: the user opens url in a browser, and get_upload_link_status with linkId reports when the file is ready to schedule.",
"inputSchema": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"enum": [
"x-media",
"tiktok-video",
"youtube-video"
],
"description": "x-media for X, tiktok-video for TikTok, youtube-video for YouTube."
}
},
"required": [
"purpose"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
get_upload_link_statusFull tools/list entry (hosted Claude list).
{
"name": "get_upload_link_status",
"title": "Get upload link status",
"description": "Check an upload link from create_upload_link. Waits up to about 20 seconds while the user hasn't finished uploading. state is \"waiting\" (the page wasn't opened or no file was chosen yet), \"uploading\", \"ready\" (schedule with uploadId), \"failed\" (error says why) or \"expired\" (the link wasn't used within 30 minutes). When ready, durationSec is a video's length in seconds for schedule_tiktok_video; it is null when the browser couldn't read it, and then the length has to come from the user.",
"inputSchema": {
"type": "object",
"properties": {
"linkId": {
"type": "string",
"pattern": "^lnk_[A-Za-z0-9_-]{22}$"
}
},
"required": [
"linkId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "schedule_x_post",
"title": "Schedule an X post",
"description": "Schedule a post, thread or long post on a connected X account. At the scheduled time Hogmatix publishes it on X, where it is public; Hogmatix never deletes published posts from X, and until then cancel_scheduled_post can cancel it. For a thread, separate the posts with a blank line. Optionally attach media uploaded with purpose x-media. Confirm the account, the exact text and the time with the user first.",
"inputSchema": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"description": "The X profile from list_accounts."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 25000
},
"format": {
"type": "string",
"enum": [
"shortform",
"thread",
"longform"
],
"default": "shortform"
},
"scheduledAt": {
"type": "string",
"description": "ISO 8601 with a time-zone offset, at least 10 minutes ahead."
},
"uploadId": {
"type": "string",
"pattern": "^upl_[A-Za-z0-9_-]{1,128}$"
}
},
"required": [
"profile",
"text",
"scheduledAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "schedule_tiktok_video",
"title": "Schedule a TikTok video",
"description": "Schedule an uploaded video (purpose tiktok-video) on a connected TikTok account. At the scheduled time Hogmatix publishes it on TikTok; Hogmatix can't remove a published video, and until then cancel_scheduled_post can cancel it. Every choice is explicit, as TikTok's Direct Post rules require: privacy (one of the account's creator-info options), the AI-generated label, commercial disclosure (yourBrand = promoting the creator's own business; brandedContent = paid promotion of a third party, only with public or friends visibility) and each interaction. Hogmatix re-checks the creator's settings and its posting-density rules. Before calling, show the user: Posting as creator_nickname (@creator_username) from get_tiktok_creator_info; the caption and time; the chosen privacy option; the comment, Duet and Stitch settings; the disclosure and AI-generated choices; and the declaration \"By posting, you agree to TikTok's Music Usage Confirmation.\" (with brandedContent: \"By posting, you agree to TikTok's Branded Content Policy and Music Usage Confirmation.\"). Then get the user's explicit go-ahead, even when the request states every choice.",
"inputSchema": {
"type": "object",
"properties": {
"openId": {
"type": "string",
"minLength": 1
},
"uploadId": {
"type": "string",
"pattern": "^upl_[A-Za-z0-9_-]{1,128}$"
},
"caption": {
"type": "string",
"maxLength": 2200
},
"scheduledAt": {
"type": "string",
"description": "ISO 8601 with a time-zone offset, at least 10 minutes ahead."
},
"privacyLevel": {
"type": "string",
"enum": [
"PUBLIC_TO_EVERYONE",
"MUTUAL_FOLLOW_FRIENDS",
"FOLLOWER_OF_CREATOR",
"SELF_ONLY"
]
},
"aiGenerated": {
"type": "boolean"
},
"yourBrand": {
"type": "boolean"
},
"brandedContent": {
"type": "boolean"
},
"allowComments": {
"type": "boolean"
},
"allowDuet": {
"type": "boolean"
},
"allowStitch": {
"type": "boolean"
},
"durationSec": {
"type": "number",
"exclusiveMinimum": 0,
"description": "The video's length in seconds. import_attached_file returns it as durationSec."
}
},
"required": [
"openId",
"uploadId",
"caption",
"scheduledAt",
"privacyLevel",
"aiGenerated",
"yourBrand",
"brandedContent",
"allowComments",
"allowDuet",
"allowStitch",
"durationSec"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
},
"execution": {
"taskSupport": "forbidden"
}
}
{
"name": "cancel_scheduled_post",
"title": "Cancel a scheduled post",
"description": "Cancel a post that has not been published yet. Cancelling is permanent: the post can't be restored, and posting it later means scheduling a new post (with its media imported or uploaded again). Posts already on X, TikTok or YouTube cannot be recalled here.",
"inputSchema": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"x",
"tiktok",
"youtube"
]
},
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The id from list_scheduled_posts or the schedule result."
}
},
"required": [
"platform",
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
},
"execution": {
"taskSupport": "forbidden"
}
}