> ## Documentation Index > Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt > Use this file to discover all available pages before exploring further. # Use tools > Choose chat, publishing, analysis, and management tools and operate them safely. ## Overview This page explains chat, publishing, analysis, generation, and management tools and safe execution. Prefer individual tools for specific goals; use `chat` only to delegate an entire multi-step workflow to the NoimosAI agent. ## Choose how to call tools The client selects tools for your request. Individual tools make operations explicit, are usually faster than `chat`, and make credit use and execution scope easier to understand. | Request | Method | Example | | - | - | - | | One defined goal | Individual tool | List workspaces, search posts, generate one image | | Combined research, decisions, and creation | `chat` | Research a brand, plan content, draft several posts | State your goal, such as “Check available workspaces,” to let the client select a tool, or name it explicitly: “Use `list_workspaces`.” ## Delegate a workflow to `chat` `chat` delegates research, analysis, writing, media generation, and other multi-step work to the NoimosAI agent. Prefer individual tools for a single search or retrieval. | Parameter | Required | Description | | - | - | - | | `deliverable` | Required for new conversations | Deliverable and quantity, such as “three Instagram drafts.” | | `outputLanguage` | Required for new conversations | Output language; Japanese uses `ja`. | | `prompt` | Yes | Background or additional instructions. | | `audience` | No | Intended audience. | | `brandContext` | No | Relevant product, price, dates, and other context. | | `voice` | No | Writing style and emoji usage. | | `constraints` | No | Character limits, CTA, prohibited wording, and other constraints. | | `workspaceId` | No | Target workspace ID. | | `sessionId` | No | Conversation ID for revising the same deliverable. | Specify deliverables, target platform and account, audience, brand or product background, tone, output language, and character limits. When a decision is needed, questions appear in `pendingQuestions` and work pauses. Call `chat` again with a `prompt` containing your answers and the same `sessionId`. ## Inspect workspaces and integrations Use these tools to inspect and connect the workspace and publishing accounts: * `list_workspaces` — Retrieve accessible workspace IDs and names. * `list_integrations` — Retrieve connected integrations and account IDs used for publishing. * `get_connect_url` — Retrieve a URL to open the specified provider’s connection screen in NoimosAI. Open the URL in a browser to complete OAuth for a new account. Then check the connection again with `list_integrations`. ## Save drafts and publish posts `post` saves drafts, publishes, or schedules social posts in NoimosAI’s post format. It accepts posts created by the connected AI or included in `chat` results. | Parameter | Type | Required | Description | | - | - | - | - | | `posts` | `array` | Yes | Post data array. Use account IDs from `list_integrations` for destinations. | | `mode` | `string` | No | `draft`, `publish`, or `schedule`. If both `mode` and the legacy `schedule` parameter are omitted, the post is saved as `draft`. | | `scheduleAt` | `string` | Conditional | Required for `mode: "schedule"`. Include the timezone. | | `workspaceId` | `string` | No | Target workspace ID. | | `dryRun` | `boolean` | No | `true` checks destinations and input format without publishing. | For real accounts, inspect the destination with `dryRun: true` first. Review text and use `mode: "publish"` or `mode: "schedule"` only after approval; use `mode: "draft"` while approval is pending. > [!WARNING] > > `dryRun` checks destinations and input format; it does not guarantee successful publication. ## Manage posts, articles, and websites Use these dedicated tools for post management, articles, and websites: * `delete_posts` — Cancel drafts or scheduled posts and delete published posts. * `publish_article` — Publish or schedule articles to WordPress, X Articles, or Substack. * `list_pinterest_boards` — Retrieve board IDs for Pinterest posts. * `create_website` / `publish_website` — Create and publish websites. Published-post deletion is irreversible. `upload_website_source`, which uploads local source code, is Local-only. ## Manage brands and knowledge bases Use these tools to maintain brand information and reference data: * `get_workspace_context` — Retrieve brand summary, goals, language, and connected accounts together. * `get_workspace_brand` / `update_workspace_brand` — Retrieve or update the complete brand guide. * `knowledge_dataset_*` / `knowledge_content_*` — Manage knowledge-base datasets and content. * `create_workspace_and_onboard` — Create a workspace and run onboarding with AI research. Use `get_workspace_context` to inspect context before composing a `chat` request. Updating `keywords` and `websites` with `update_workspace_brand` replaces each entire list. Knowledge ingestion consumes NoimosAI credits for embeddings. Workspace creation requires plan capacity and team permissions. ## Reply to DMs and comments Retrieve target IDs with read tools, then review the message. * `send_dm` — Send text to existing DM threads on X, Instagram, Facebook, and TikTok. * `reply_to_comment` — Reply to comments or mentions on X or Instagram. These tools send immediately without creating drafts. Show the account, target ID, and text, and obtain explicit approval before sending. Get DM IDs with `get_direct_messages` and comment-related IDs with tools such as `list_x_user_mentions`, `instagram_comments_list`, and `instagram_mentioned_comment_get`. ## Use individual search, analysis, and generation tools On connection, tools available to the workspace are loaded. Use past posts, social search, trends, GA4, Google Search Console, Semrush, site analysis, research, and media generation as needed. Tools labeled `[Billed]` consume NoimosAI credits according to actual processing. Starting offline or unauthenticated may load only basic tools without the catalog. ## Generate images and videos Review models and costs before generating, then retrieve status and artifacts from creation history. | Stage | Main tools | Purpose | | - | - | - | | Select a model | `list_media_models`, `get_media_model_form` | Check models, inputs, and capabilities | | Check cost | `get_media_model_cost` | Get a NoimosAI credit estimate before generating | | Generate or edit | `generate_image`, `generate_video`, `edit_image`, `edit_video` | Create media or edit existing media | | Get status and artifacts | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | Inspect processing and retrieve files | | Prepare inputs | `upload_media` | Upload allowed local files through Local MCP | Ask “List available image models,” then “Check the estimate and inputs for one square image with this model.” Generate only after reviewing model, inputs, and estimate. `upload_media` sends file contents to NoimosAI. Review the file and purpose and obtain explicit approval for that upload before running it. ## Review consequential operations Even if the AI proposes an operation, a person should review targets and content before: * Publishing or scheduling posts, articles, or websites * Sending DMs or comments * Deleting published posts * Updating or deleting brands and knowledge data * Uploading local files * Running tools that consume NoimosAI credits Even when the client shows a confirmation, check the NoimosAI destination, workspace, and account IDs. ## Related pages See these pages for connection settings and other access methods. * [Connect clients](https://docs.noimosai.com/developers/mcp/setup.md) * [Understand the basics](https://docs.noimosai.com/developers/cli/overview.md) * [npm package](https://www.npmjs.com/package/@noimosai/mcp) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.