Yourware MCP acts as a bridge between a local coding project and the Yourware platform. In the simplest terms, it allows an AI assistant to take files or even entire folders from a computer and upload them directly to the web. This makes it incredibly easy to move work from a local environment to a live platform without having to manually drag and drop files or navigate complex upload interfaces. For developers, this tool serves as a streamlined deployment pipeline integrated directly into an AI-driven workflow. It supports both single-file uploads and full directory structures, making it versatile for everything from sharing a quick script to deploying a complete application. It is designed to work seamlessly with popular AI code editors and command-line interfaces like Cursor, Cline, Windsurf, and Claude Code, allowing users to trigger uploads using natural language commands during a conversation with their AI. On a more technical level, the server operates via the Model Context Protocol using a standard input/output communication channel. It can be initialized quickly using the `uvx` package runner, ensuring the AI always has access to the latest version of the tool. Security is managed through an API key environment variable, which the AI can even help the user configure and store. By automating the transition from local code to a hosted environment, this MCP server empowers AI assistants to handle the logistics of project distribution and deployment.
1. Installation Pre-requisites: 1. Login to yourware.so. 2. Create a new API key and set the YOURWARE_API_KEY environment variable. 3. Ensure you have uv installed to use the uvx command.
2. Configuration
General Configuration (Claude Desktop, Cline, Windsurf) Add the following to your MCP settings file: json { "mcpServers": { "yourware-mcp": { "command": "uvx", "args": ["yourware-mcp@latest", "stdio"], "env": { "YOURWARE_API_KEY": "YOUR_API_KEY_HERE" } } } }
Cursor Configuration 1. Go to Cursor Settings -> Features -> MCP Servers. 2. Click Add a new MCP Server. 3. Name: yourware-mcp. 4. Command: uvx yourware-mcp@latest stdio.
Claude Code Configuration Run the following command in your terminal: bash claude mcp add yourware-mcp -s user -- uvx yourware-mcp@latest stdio
3. Available Tools The Yourware MCP server provides tools to interact with the Yourware platform: * Upload Project/Files: Upload single files or entire directories to the Yourware platform for hosting/deployment.
4. Example Prompts * "Upload my current project directory to Yourware." * "Upload this specific file to Yourware." * "Deploy my project files to the Yourware platform."
What you can do with Yourware MCP
Use Case 1: Instant Deployment of Frontend Prototypes Problem: After using an AI coding assistant (like Cursor or Windsurf) to generate a landing page or a React prototype, the developer usually has to manually initialize a git repo, set up a hosting provider (like Vercel or Netlify), and run deployment commands to see it live or share it. Solution: The Yourware MCP allows the AI assistant to instantly upload the entire project directory to the Yourware platform. This creates a live URL in seconds without the user ever leaving the chat interface. Example: A user tells Claude: "I'm happy with this Tailwind landing page. Use the Yourware MCP to upload the current folder so I can send the live link to my client for feedback."
Use Case 2: Sharing Specific Code Context for Reviews Problem: When seeking feedback on a specific module or a complex set of files, copy-pasting code into Slack or Discord loses directory structure and syntax highlighting, while GitHub pull requests might be too "heavy" for a quick informal check. Solution: Developers can use the MCP to upload a specific directory to Yourware. This provides a clean, web-based view of the files that can be shared via a single URL, maintaining the project structure. Example: "Upload the `src
middleware` directory to Yourware. I need to share the logic with the security team to make sure I haven't missed any edge cases."
Use Case 3: Seamless Handover of AI-Generated Utilities Problem: Non-technical users often ask AI agents (like Claude Code) to build small utility tools (e.g., a simple internal calculator or a data visualizer). However, these users often don't know how to run the code locally or host it themselves. Solution: The AI can build the tool and then use the Yourware MCP to host it immediately. The user receives a functional URL where the tool is already running, bypassing the need for local environment setup. Example: A marketing manager asks an AI agent to build a "UTM Link Generator." After the agent writes the HTML and JavaScript, it says: "I've built the tool and uploaded it to Yourware. You can access it here: [URL provided by MCP]."
Use Case 4: Persistent Archiving of Chat-Generated Experiments Problem: During long AI coding sessions, many versions of a project are created. If the local environment is wiped or the files are overwritten, those specific experimental versions are…