# Copysmith MCP MCP > Copysmith handles content creation and file management for marketing teams. Use this MCP to generate product descriptions, ad copy variations, and blog intros at scale using high-fidelity templates. It lets you build a structured content repository and keeps track of your usage credits—all through conversation with your AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** copysmith, ai-copywriting, content-generation-api, marketing-automation, ad-copy, product-descriptions, creative-writing, content-management, mcp ## Description Stop copying and pasting content between tabs. This connector gives your AI client direct access to Copysmith's entire marketing workflow. You can tell it, for instance, 'Create three ad variations for our new widget using the Holiday Sale template,' and get the copy immediately. The system doesn't just generate text; it organizes everything into folders and files so you always know where your assets live. It even tracks your credit balance automatically. This gives you full control over content production without needing to touch a dashboard. Because Vinkius hosts this MCP, connecting it is easy: you link up once from any compatible AI client and access the entire catalog of tools needed for marketing, file management, and more. ## Tools ### create_folder Creates a new folder in your content repository. ### create_generation Starts the process of generating AI-powered copy based on a prompt and template. ### delete_file Removes an existing file from your content repository. ### delete_folder Permanently deletes an entire folder structure. ### get_credits Checks and reports how many content generation credits you have remaining. ### get_file Retrieves specific details about a file, including its contents or metadata. ### get_generation Checks the status of an active content generation job to see if it's finished yet. ### get_template Retrieves details about a specific copywriting template, including its requirements. ### get_user_info Fetches basic user account information for verification purposes. ### list_files Shows a list of files, optionally filtered to only show content within one specific folder. ### list_folders Lists all the main folders currently set up in your repository. ### list_templates Retrieves a list of every content template available for use (e.g., Product Description, Blog Intro). ## Prompt Examples **Prompt:** ``` Generate a product description for 'AI Project Manager' using the 'Product Description' template. ``` **Response:** ``` Generation triggered! I've started creating your product description for 'AI Project Manager'. The job ID is 'gen_123'. I'll retrieve the finalized copy for you as soon as it's ready. ``` **Prompt:** ``` Show me all my content folders and files in Copysmith. ``` **Response:** ``` I've retrieved your content hierarchy. You have 2 folders: 'Q1 Campaigns' and 'Drafts', with a total of 15 saved files. Which one would you like to inspect? ``` **Prompt:** ``` Check my remaining credits balance. ``` **Response:** ``` Scanning account... You have 1,240 credits remaining. Based on your current usage, you can generate approximately 50 more high-quality articles. Need any help with a new campaign? ``` ## Capabilities ### Generate high-quality marketing copy Create multiple pieces of content—from product descriptions to Facebook ads—using pre-built templates. ### Manage a structured content library Organize, retrieve, and delete files and folders in your dedicated content repository. ### Access and utilize copy templates View all available copywriting template types and check their required input parameters directly through the agent. ### Monitor usage and budget status Check your remaining credit balance to keep track of content production costs. ### Automate content drafting workflows Initiate content generation jobs, check their progress, and retrieve the final results programmatically. ## Use Cases ### Launching a product line of 50 items. The agent first uses `list_templates` to confirm the 'Product Description' template is available. It then loops through the product data, calling `create_generation` for each item and using `create_folder` to house all 50 descriptions in a new 'Q4 Launch' folder. ### Preparing content for three different client campaigns. The user asks the agent to list folders. The agent uses `list_folders` to confirm 'Client A', 'Client B', and 'Drafts' exist. It then runs multiple separate generation jobs, keeping each campaign's output contained within its dedicated folder. ### Cleaning up old marketing assets. A team member needs to retire an entire product line. They ask the agent to list files in the 'Legacy Products' folder, and then use `delete_file` on all outdated ad copies, followed by `delete_folder` once everything is confirmed gone. ### Checking if a large batch of copy jobs finished. The agent initiates several generation jobs. The user can periodically ask the agent to check the status using `get_generation`, which confirms when each job ID has returned its final content. ## Benefits - You keep a perfect record of everything. By using `create_folder` and `list_files`, you organize all client content into structured, retrievable folders, eliminating the chance of losing drafts. - Content creation becomes instant. Instead of writing prompts manually, simply call `create_generation` with your required template name to start drafting copy right away. - You always know your limits. Running `get_credits` provides a clear count of remaining credits so you can budget your content production across campaigns without surprise fees. - Templates are never guesswork. Calling `list_templates` and then `get_template` shows you exactly what input is needed for any job, preventing failed generations. - Workflows become predictable. The agent manages the entire cycle: it uses `create_generation`, waits, checks status with `get_generation`, and finally retrieves the content via a file action. ## How It Works The bottom line is: your AI agent acts as both your dedicated copywriter and your content coordinator in one chat session. 1. Subscribe to this MCP and grab your API key from your Copysmith account dashboard. 2. Connect that key in your preferred AI client (Claude, Cursor, etc.). 3. Tell your agent what you need—for example, 'Generate a product description for the new vacuum cleaner'—and it executes the job. ## Frequently Asked Questions **How do I check if my content generation jobs are finished using get_generation?** You use `get_generation` with the job ID. This tool tells you the current status (e.g., 'PENDING' or 'COMPLETED'). You keep checking it until the agent confirms the final copy is ready for retrieval. **What should I do if I need to organize my ad copies into a new campaign folder?** First, call `create_folder` and give it the name of your campaign. Then, use that folder name when generating content or listing files so everything stays contained. **Can I see what templates are available before starting a job? Using list_templates?** Yes, calling `list_templates` shows you every template type ready for use. You can then call `get_template` to understand the exact required input fields. **How do I manage my content budget? Should I worry about get_credits?** You run `get_credits` anytime to see your current balance. This prevents you from running out of credits mid-campaign, keeping your content workflow predictable. **How do I view my entire content hierarchy, including all files, using list_files?** It lists everything saved in your repository. You can filter results by specific folders to see exactly what you need without manually browsing the interface. **If I want to remove an old draft or archive a file, how do I use delete_file?** Using delete_file immediately removes the content. Be careful, as this action is permanent and cannot be undone within your agent workflow. **What information does get_template provide before I start generating copy?** It retrieves all details for a specific template. This tool shows you the exact input parameters needed, ensuring your prompt structure is perfect before generation. **How can my agent check general account status or user permissions using get_user_info?** This confirms core account details and associated service limits. It gives you a high-level view of the connected account, separate from checking your current credit balance. **How do I find my Copysmith API Key?** Log in to your account, navigate to **Settings** > **API**, and copy your secret access token from the dashboard. **How many credits are used per generation?** Credit consumption depends on the complexity and length of the content generated. You can check your balance using the `get_credits` tool. **Can I list available templates via AI?** Yes! The `list_templates` tool retrieves all active copywriting models available for your account.