@onlypult/mcp 0.1.0

package/dist/schemas/platform-options.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+/**
+ * Per-platform settings passed as platform_options.{key} in POST/PUT /v1/posts.
+ * Keys: instagram, facebook, youtube, tiktok, telegram, linkedin, pinterest,
+ * twitter, threads, bluesky, wordpress, google_my_business, vkontakte.
+ */
+export const platformSettingsSchema = z
+    .object({
+    is_story: z.boolean().optional().describe('Instagram/Facebook/VK story (mutually exclusive with is_reels, is_shorts)'),
+    is_reels: z.boolean().optional().describe('Instagram/Facebook Reels (mutually exclusive with is_story, is_shorts)'),
+    is_shorts: z.boolean().optional().describe('YouTube Shorts (mutually exclusive with is_story, is_reels)'),
+    title: z.string().optional().describe('Platform-specific title (overrides top-level title)'),
+    privacy: z
+        .string()
+        .optional()
+        .describe('YouTube: public|unlisted|private. TikTok: PUBLIC_TO_EVERYONE|MUTUAL_FOLLOW_FRIENDS|FOLLOWER_OF_CREATOR|SELF_ONLY'),
+    category: z.string().optional().describe('YouTube category ID — call profiles_get_youtube_categories first'),
+    disable_comment: z.boolean().optional().describe('TikTok: disable comments'),
+    disable_duet: z.boolean().optional().describe('TikTok: disable duet'),
+    disable_stitch: z.boolean().optional().describe('TikTok: disable stitch'),
+    disable_notification: z.boolean().optional().describe('Telegram: send silently'),
+    pin_message: z.boolean().optional().describe('Telegram: pin after publish'),
+    visibility: z.enum(['PUBLIC', 'CONNECTIONS']).optional().describe('LinkedIn post visibility'),
+    board_id: z.string().optional().describe('Pinterest board ID — call profiles_get_pinterest_boards first'),
+    link: z.string().optional().describe('Pinterest destination link'),
+    alt_text: z.string().optional().describe('Pinterest image alt text'),
+})
+    .strict();
+export const platformOptionsSchema = z
+    .object({
+    instagram: platformSettingsSchema.optional(),
+    facebook: platformSettingsSchema.optional(),
+    youtube: platformSettingsSchema.optional(),
+    tiktok: platformSettingsSchema.optional(),
+    telegram: platformSettingsSchema.optional(),
+    linkedin: platformSettingsSchema.optional(),
+    pinterest: platformSettingsSchema.optional(),
+    twitter: platformSettingsSchema.optional(),
+    threads: platformSettingsSchema.optional(),
+    bluesky: platformSettingsSchema.optional(),
+    wordpress: platformSettingsSchema.optional(),
+    google_my_business: platformSettingsSchema.optional(),
+    vkontakte: platformSettingsSchema.optional(),
+})
+    .strict()
+    .optional();
+export const PLATFORM_OPTIONS_HINT = `platform_options: per-platform settings object. Example:
+{ "instagram": { "is_reels": true }, "youtube": { "is_shorts": true, "privacy": "public" } }
+Post type flags (at most one per platform): is_story, is_reels, is_shorts.
+Other fields: privacy, category (YouTube — use profiles_get_youtube_categories); disable_comment, disable_duet, disable_stitch (TikTok);
+disable_notification, pin_message (Telegram); visibility (LinkedIn); board_id (Pinterest — use profiles_get_pinterest_boards), link, alt_text (Pinterest).`;
+export function mergePlatformOptions(base, overrides) {
+    if (!base && !overrides) {
+        return undefined;
+    }
+    const result = { ...(base ?? {}) };
+    if (overrides) {
+        for (const [platform, settings] of Object.entries(overrides)) {
+            if (!settings) {
+                continue;
+            }
+            const key = platform;
+            result[key] = { ...(result[key] ?? {}), ...settings };
+        }
+    }
+    return result;
+}
+export const STORY_PLATFORM_OPTIONS = {
+    instagram: { is_story: true },
+    facebook: { is_story: true },
+    vkontakte: { is_story: true },
+};
+export const REELS_PLATFORM_OPTIONS = {
+    instagram: { is_reels: true },
+    facebook: { is_reels: true },
+};
+export const SHORTS_PLATFORM_OPTIONS = {
+    youtube: { is_shorts: true },
+};
+//# sourceMappingURL=platform-options.js.map

package/dist/schemas/platform-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-options.js","sourceRoot":"","sources":["../../src/schemas/platform-options.ts"],"names":[],"mappings":"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"}

package/dist/tools/media.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../types.js';
+export declare function registerMediaTools(server: McpServer, ctx: () => ToolContext): void;

package/dist/tools/media.js

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import { apiErrorResult } from '../api-error.js';
+import { isLocalFileUploadError, uploadLocalFile } from '../media-upload.js';
+const BROWSER_UPLOAD_TOOL_DESCRIPTION = `Generate a browser upload URL for images or videos (fallback upload flow).
+
+**When to use:**
+- No readable file_path on disk (chat attachment only, path unknown)
+- User prefers to upload manually in a browser
+- Multiple files in one drag-and-drop session
+
+**When NOT to use (prefer media_upload_file instead):**
+- @onlypult/mcp runs locally (this package) and you have a workspace file path
+- Example: ./assets/photo.jpg or /home/user/project/temp/118.jpg
+- File already at a public HTTP(S) URL → use media_urls in posts_create
+
+Flow:
+1. Call this tool → get upload_url and token
+2. Ask user to open upload_url in browser
+3. User uploads files via the web page
+4. Call media_check_status with the token
+5. Use file IDs in posts_create / posts_update (media_ids)
+
+Match is_story / is_reels with post tools and platform_options when applicable.
+
+Supported: JPG, PNG, WebP, GIF, MP4, MOV, WebM. Max size: plan-dependent (up to 1GB).`;
+const LOCAL_UPLOAD_TOOL_DESCRIPTION = `Upload a local image or video file directly to Onlypult (no browser step).
+
+**When to use (preferred with @onlypult/mcp local package):**
+- This MCP server runs on the user's machine via stdio (Cursor, Claude Desktop, Windsurf)
+- You have an absolute or workspace-relative file_path the server can read
+- Example: /home/user/project/assets/photo.jpg or ./marketing/video.mp4
+
+**When NOT to use:**
+- file_path is missing or not on disk → use media_get_upload_url (browser) instead
+- File is only a chat attachment without a saved path on disk
+- File is already at a public URL → use media_urls in posts_create
+
+Creates an upload session automatically unless token is provided (from media_get_upload_url).
+Uses multipart upload internally for files larger than 5MB.
+
+Returns file id for media_ids in posts_create / posts_update.`;
+export function registerMediaTools(server, ctx) {
+    server.tool('media_get_upload_url', BROWSER_UPLOAD_TOOL_DESCRIPTION, {
+        is_story: z.boolean().optional().describe('Upload as Instagram/Facebook story (default: false)'),
+        is_reels: z.boolean().optional().describe('Upload as Instagram Reels (default: false)'),
+    }, async ({ is_story, is_reels }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.post('/v1/media/upload-url', {
+                is_story: is_story ?? false,
+                is_reels: is_reels ?? false,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `Upload URL generated (browser flow).`,
+                            ``,
+                            `Open this link in your browser to upload files:`,
+                            data.upload_url,
+                            ``,
+                            `Token: ${data.token}`,
+                            ``,
+                            `After uploading, say "done" and I'll check the status with media_check_status.`,
+                            ``,
+                            `Tip: with @onlypult/mcp (local), prefer media_upload_file when you have a file_path on disk.`,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('media_upload_file', LOCAL_UPLOAD_TOOL_DESCRIPTION, {
+        file_path: z.string().describe('Absolute or relative path to a local file readable by the MCP server'),
+        token: z.string().optional().describe('Optional upload session token from media_get_upload_url (auto-created if omitted)'),
+        is_story: z.boolean().optional().describe('Upload as Instagram/Facebook story (default: false)'),
+        is_reels: z.boolean().optional().describe('Upload as Instagram Reels (default: false)'),
+    }, async ({ file_path, token, is_story, is_reels }) => {
+        try {
+            const { api, apiKey } = ctx();
+            const file = await uploadLocalFile(apiKey, api, file_path, {
+                token,
+                is_story,
+                is_reels,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `File uploaded successfully.`,
+                            ``,
+                            `ID: ${file.id}`,
+                            `Filename: ${file.filename ?? file_path}`,
+                            `Type: ${file.type ?? 'unknown'}`,
+                            `Session token: ${file.token}`,
+                            ``,
+                            `Use media_ids: ["${file.id}"] in posts_create or posts_update.`,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (isLocalFileUploadError(err)) {
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],
+                };
+            }
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('media_check_status', `Check upload session status and list file IDs.
+
+Use after media_get_upload_url browser flow when the user says "done".
+Not needed after media_upload_file (file id is returned immediately).
+
+| token | string | Yes | Token from media_get_upload_url |`, {
+        token: z.string().describe('The upload token from media_get_upload_url'),
+    }, async ({ token }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get(`/v1/media/upload-status/${token}`);
+            if (data.status === 'pending') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Upload is still in progress. Please wait a moment and try again.',
+                        },
+                    ],
+                };
+            }
+            if (data.status === 'failed') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Upload failed. Please try again using media_get_upload_url or media_upload_file.',
+                        },
+                    ],
+                };
+            }
+            const fileList = data.files.map(f => `- ${f.filename} (${f.type}) — ID: ${f.id}`).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `Upload completed! ${data.files.length} file(s) ready:`,
+                            fileList,
+                            ``,
+                            `File IDs: ${data.files.map(f => f.id).join(', ')}`,
+                            `Use these IDs in the media_ids parameter when creating your post.`,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=media.js.map

package/dist/tools/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"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"}

package/dist/tools/posts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../types.js';
+export declare function registerPostTools(server: McpServer, ctx: () => ToolContext): void;

package/dist/tools/posts.js

@@ -0,0 +1,188 @@
+import { z } from 'zod';
+import { apiErrorResult } from '../api-error.js';
+import { PLATFORM_OPTIONS_HINT, REELS_PLATFORM_OPTIONS, SHORTS_PLATFORM_OPTIONS, STORY_PLATFORM_OPTIONS, mergePlatformOptions, platformOptionsSchema, } from '../schemas/platform-options.js';
+const PUBLISH_AT_HINT = 'Schedule time in account timezone, format "Y-m-d H:i" (e.g. "2026-07-07 14:00"). Call account_get for timezone and plan_end_at.';
+const postCreateBaseSchema = {
+    content: z.string().optional().describe('Post text/content. Required unless media_ids or media_urls provided.'),
+    profile_ids: z.array(z.string()).describe('Profile IDs to post to (from profiles_list)'),
+    is_draft: z.boolean().optional().describe('Save as draft without publishing (default: false)'),
+    publish_now: z.boolean().optional().describe('Publish immediately (default: false)'),
+    publish_at: z.string().optional().describe(PUBLISH_AT_HINT),
+    title: z.string().optional().describe('Post title (required for YouTube, recommended for Pinterest)'),
+    media_ids: z.array(z.string()).optional().describe('Media file IDs from media_check_status'),
+    media_urls: z
+        .array(z.string().url())
+        .optional()
+        .describe('Public image/video URLs (downloaded server-side, up to 10)'),
+    platform_options: platformOptionsSchema.describe(PLATFORM_OPTIONS_HINT),
+};
+async function createPost(ctx, params) {
+    try {
+        const { api } = ctx();
+        const data = await api.post('/v1/posts', params);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    catch (err) {
+        return apiErrorResult(err);
+    }
+}
+export function registerPostTools(server, ctx) {
+    server.tool('posts_create', `Create a social media post in Onlypult. Choose the correct mode:
+- DRAFT (is_draft=true): save without scheduling
+- PUBLISH NOW (publish_now=true): post immediately
+- SCHEDULED (default): provide publish_at in "Y-m-d H:i" format (account timezone)
+
+Before scheduling, call account_get to check plan_end_at and timezone.
+If API returns retryable=false, do NOT retry — explain the issue to the user.
+
+For Story / Reels / Shorts use posts_create_story, posts_create_reels, posts_create_shorts,
+or set platform_options (e.g. instagram.is_reels=true, youtube.is_shorts=true).
+
+${PLATFORM_OPTIONS_HINT}
+
+Call profiles_list first to get profile IDs.`, postCreateBaseSchema, async (params) => createPost(ctx, params));
+    server.tool('posts_create_story', `Create a Story post (Instagram, Facebook, VK). Requires video or image media.
+Sets platform_options is_story=true for supported platforms. Merge with platform_options for extra settings.`, postCreateBaseSchema, async (params) => createPost(ctx, {
+        ...params,
+        platform_options: mergePlatformOptions(STORY_PLATFORM_OPTIONS, params.platform_options),
+    }));
+    server.tool('posts_create_reels', `Create an Instagram/Facebook Reels post. Requires vertical video media.
+Sets platform_options is_reels=true for Instagram and Facebook.`, postCreateBaseSchema, async (params) => createPost(ctx, {
+        ...params,
+        platform_options: mergePlatformOptions(REELS_PLATFORM_OPTIONS, params.platform_options),
+    }));
+    server.tool('posts_create_shorts', `Create a YouTube Shorts post. Requires short vertical video.
+Sets platform_options youtube.is_shorts=true.`, postCreateBaseSchema, async (params) => createPost(ctx, {
+        ...params,
+        platform_options: mergePlatformOptions(SHORTS_PLATFORM_OPTIONS, params.platform_options),
+    }));
+    server.tool('posts_publish_now', 'Publish a post immediately. Convenience shortcut — sets publish_now=true.', {
+        content: z.string().optional().describe('Post text/content'),
+        profile_ids: z.array(z.string()).describe('Profile IDs to post to'),
+        title: z.string().optional().describe('Post title (required for YouTube)'),
+        media_ids: z.array(z.string()).optional().describe('Media file IDs'),
+        media_urls: z.array(z.string().url()).optional().describe('Public media URLs'),
+        platform_options: platformOptionsSchema.describe(PLATFORM_OPTIONS_HINT),
+    }, async (params) => createPost(ctx, { ...params, publish_now: true }));
+    server.tool('posts_cross_post', 'Post the same content to multiple profiles at once. Can publish now or schedule.', {
+        content: z.string().optional().describe('Post text/content'),
+        profile_ids: z.array(z.string()).min(2).describe('At least 2 profile IDs'),
+        publish_now: z.boolean().optional().describe('Publish immediately (default: false)'),
+        publish_at: z.string().optional().describe(PUBLISH_AT_HINT),
+        media_ids: z.array(z.string()).optional().describe('Media file IDs'),
+        media_urls: z.array(z.string().url()).optional().describe('Public media URLs'),
+        platform_options: platformOptionsSchema.describe(PLATFORM_OPTIONS_HINT),
+    }, async (params) => createPost(ctx, params));
+    server.tool('posts_list', 'List posts in your Onlypult workspace with optional filters.', {
+        status: z.enum(['draft', 'scheduled', 'published', 'failed']).optional().describe('Filter by post status'),
+        profile_id: z.string().optional().describe('Filter by profile ID'),
+        limit: z.number().int().min(1).max(100).optional().describe('Max posts to return (default: 20)'),
+        page: z.number().int().min(1).optional().describe('Page number (default: 1)'),
+    }, async (params) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get('/v1/posts', params);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_list_failed', 'List all failed posts that need to be retried.', {
+        profile_id: z.string().optional().describe('Filter by profile ID'),
+        limit: z.number().int().min(1).max(100).optional().describe('Max posts to return (default: 20)'),
+    }, async (params) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get('/v1/posts', { ...params, status: 'failed' });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_get', 'Get post details including is_story, is_reels, is_shorts flags, status, and error info if failed.', {
+        post_id: z.string().describe('The post ID'),
+    }, async ({ post_id }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get(`/v1/posts/${post_id}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_update', `Update a draft or scheduled post. Cannot update published posts.
+${PLATFORM_OPTIONS_HINT}`, {
+        post_id: z.string().describe('The post ID to update'),
+        content: z.string().optional().describe('New post text/content'),
+        publish_at: z.string().optional().describe(PUBLISH_AT_HINT),
+        title: z.string().optional().describe('New title'),
+        media_ids: z.array(z.string()).optional().describe('New media file IDs (replaces existing)'),
+        media_urls: z.array(z.string().url()).optional().describe('Public URLs merged with media_ids'),
+        platform_options: platformOptionsSchema.describe(PLATFORM_OPTIONS_HINT),
+    }, async ({ post_id, ...params }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.put(`/v1/posts/${post_id}`, params);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_delete', 'Delete a post. Only draft and scheduled posts can be deleted.', {
+        post_id: z.string().describe('The post ID to delete'),
+    }, async ({ post_id }) => {
+        try {
+            const { api } = ctx();
+            await api.delete(`/v1/posts/${post_id}`);
+            return {
+                content: [{ type: 'text', text: `Post ${post_id} deleted successfully.` }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_retry', 'Retry a failed post. The post will be re-queued for publishing.', {
+        post_id: z.string().describe('The ID of the failed post to retry'),
+    }, async ({ post_id }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.post(`/v1/posts/${post_id}/retry`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('posts_retry_all_failed', 'Retry all failed posts at once, optionally filtered by profile.', {
+        profile_id: z.string().optional().describe('Only retry failed posts for this profile'),
+    }, async (params) => {
+        try {
+            const { api } = ctx();
+            const data = await api.post('/v1/posts/retry-all-failed', params);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"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"}

package/dist/tools/profiles.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../types.js';
+export declare function registerProfileTools(server: McpServer, ctx: () => ToolContext): void;

package/dist/tools/profiles.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { apiErrorResult } from '../api-error.js';
+export function registerProfileTools(server, ctx) {
+    server.tool('account_get', 'Get account scheduling context: timezone, plan end date, and publish_at format. Call before scheduling posts.', {}, async () => {
+        try {
+            const { api } = ctx();
+            const data = await api.get('/v1/account');
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('profiles_list', 'List all connected social media profiles (accounts) in your Onlypult workspace. Returns platform, name, username, status, and profile ID for each account.', {}, async () => {
+        try {
+            const { api } = ctx();
+            const data = await api.get('/v1/profiles');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('profiles_get', 'Get details of a specific social media profile by its ID.', {
+        profile_id: z.string().describe('The profile ID (from profiles_list)'),
+    }, async ({ profile_id }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get(`/v1/profiles/${profile_id}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('profiles_platforms_list', 'List all social media platforms supported by Onlypult (e.g. instagram, facebook, twitter, tiktok, youtube, linkedin, telegram, bluesky, threads, pinterest, googleGmb, wordpress, vkontakte).', {}, async () => {
+        try {
+            const { api } = ctx();
+            const data = await api.get('/v1/profiles/platforms');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('profiles_get_pinterest_boards', 'List Pinterest boards for a profile. Returns id and name for each board — use id in platform_options.pinterest.board_id when creating a post.', {
+        profile_id: z.string().describe('Pinterest profile ID (from profiles_list)'),
+    }, async ({ profile_id }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get(`/v1/profiles/${profile_id}/pinterest-boards`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+    server.tool('profiles_get_youtube_categories', 'List YouTube video categories for a profile. Returns id and name — use id in platform_options.youtube.category when creating a post.', {
+        profile_id: z.string().describe('YouTube profile ID (from profiles_list)'),
+    }, async ({ profile_id }) => {
+        try {
+            const { api } = ctx();
+            const data = await api.get(`/v1/profiles/${profile_id}/youtube-categories`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            return apiErrorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=profiles.js.map

package/dist/tools/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/tools/profiles.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+import type { ApiClient } from './api-client.js';
+export interface ToolContext {
+    api: ApiClient;
+    apiKey: string;
+}
+export interface Profile {
+    id: string;
+    name: string;
+    username: string | null;
+    platform: string;
+    profile_type: string;
+    status: string;
+    picture: string | null;
+    platform_id: string;
+    typeName: string;
+}
+export interface Post {
+    id: string;
+    status: 'draft' | 'scheduled' | 'published' | 'failed';
+    content: string;
+    publish_at: string | null;
+    published_at: string | null;
+    platform: string;
+    profile_id: string;
+    media: MediaFile[];
+    error?: string;
+}
+export interface MediaFile {
+    id: string;
+    url: string;
+    type: 'image' | 'video';
+    filename: string;
+}
+export interface PostCreateParams {
+    content: string;
+    profile_ids: string[];
+    publish_at?: string;
+    publish_now?: boolean;
+    is_draft?: boolean;
+    media_ids?: string[];
+    title?: string;
+}
+export interface UploadUrlResponse {
+    token: string;
+    upload_url: string;
+}
+export interface UploadStatusResponse {
+    status: 'pending' | 'done' | 'failed';
+    files: MediaFile[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}