{"id":50666849,"url":"https://github.com/decocms/mcp-vtex","last_synced_at":"2026-06-08T07:05:46.758Z","repository":{"id":321407791,"uuid":"1085696382","full_name":"decocms/mcp-vtex","owner":"decocms","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-10T18:17:42.000Z","size":432,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-10T20:22:01.973Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/decocms.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-29T11:47:48.000Z","updated_at":"2025-11-10T18:17:46.000Z","dependencies_parsed_at":"2025-10-29T14:36:32.256Z","dependency_job_id":null,"html_url":"https://github.com/decocms/mcp-vtex","commit_stats":null,"previous_names":["decocms/mcp-vtex"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/decocms/mcp-vtex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decocms%2Fmcp-vtex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decocms%2Fmcp-vtex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decocms%2Fmcp-vtex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decocms%2Fmcp-vtex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decocms","download_url":"https://codeload.github.com/decocms/mcp-vtex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decocms%2Fmcp-vtex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34051794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-08T07:05:10.815Z","updated_at":"2026-06-08T07:05:46.750Z","avatar_url":"https://github.com/decocms.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deco AI App Template\n\n**The fastest way to build AI-powered applications with instant access to thousands of APIs.**\n\nThis is the official template used when you run `npm create deco@latest` to bootstrap your AI application. Built on the [Model Context Protocol (MCP)](https://spec.modelcontextprotocol.io/), this template gives you everything you need to create powerful AI apps that can connect to any service, API, or data source.\n\n## 🌟 What You Can Build\n\nWith this template, you can rapidly create AI applications that:\n\n- **🔌 Connect to Thousands of APIs**: Instant integration with popular services like OpenAI, Stripe, SendGrid, databases, and more through MCP protocol\n- **🤖 AI-Native Tools**: Create intelligent tools that leverage AI for data processing, analysis, and automation  \n- **⚡ Real-time Collaboration**: Build collaborative AI experiences with live updates and shared state\n- **🎨 Beautiful Interfaces**: Modern React frontend with Tailwind CSS and shadcn/ui components\n- **🚀 Production Ready**: Deploy instantly to Cloudflare Workers with global edge distribution\n\n## 🔥 MCP Protocol Power\n\nThe Model Context Protocol enables your AI app to seamlessly connect with:\n- **External APIs** (REST, GraphQL, webhooks)\n- **Databases** (PostgreSQL, MySQL, MongoDB, and more)\n- **AI Services** (OpenAI, Anthropic, local models)\n- **Business Tools** (CRM, analytics, payment processors)\n- **Custom Integrations** (your own services and APIs)\n\nAll with **type-safe**, **auto-generated** client code and **zero configuration**.\n\n## 📝 Development History\n\nThis repository uses [Specstory](https://specstory.com/) to track the history of\nprompts that were used to code this repo. You can inspect the complete\ndevelopment history in the [`.specstory/`](.specstory/) folder.\n\n## ✨ Template Features\n\n- **🤖 MCP Server**: Cloudflare Workers-based server with typed AI tools\n- **⚛️ React Frontend**: Modern React app with Vite, TanStack Router, and Tailwind CSS\n- **🎨 UI Components**: Pre-configured shadcn/ui components for rapid development\n- **🔧 Type Safety**: Full TypeScript support with auto-generated RPC client types\n- **🚀 Hot Reload**: Live development with automatic rebuilding for both frontend and backend\n- **☁️ Ready to Deploy**: One-command deployment to Cloudflare Workers\n- **🔗 API Integrations**: Connect to thousands of services through deco marketplace\n- **🛡️ Built-in Auth**: OAuth integration with popular providers (Google, GitHub, etc.)\n- **🗄️ Integrated Database**: SQLite database with 10GB storage included in every project\n\n## 🚧 Coming Soon: Visual Workflow Editor\n\nWe're finishing our **visual workflow editor** where you'll be able to:\n- **🎨 Drag \u0026 Drop**: Compose AI tools visually with an intuitive interface\n- **🤝 Real-time Collaboration**: Work together on workflows with your team\n- **🧠 AI-Generated Workflows**: Let AI help you build complex automation flows\n- **⚡ Live Preview**: See your workflows in action as you build them\n\n*This will revolutionize how you create AI-powered automation and data processing pipelines.*\n\n## 🚀 Quick Start\n\n### Two Ways to Create Your AI App\n\n#### Option 1: Using npm create (Recommended)\n\n```bash\n# Create a new AI app from this template\nnpm create deco@latest my-ai-app\n\n# Navigate to your project\ncd my-ai-app\n\n# Configure your app (sets name, scope, and workspace)\nnpm run configure\n\n# Start development server\nnpm run dev\n```\n\n#### Option 2: Using GitHub Template\n\nYou can also create a new app by using this repository as a GitHub template:\n\n1. Click \"Use this template\" on GitHub to create a new repository\n2. Clone your new repository\n3. Install dependencies and configure:\n\n```bash\ngit clone \u003cyour-new-repo-url\u003e\ncd \u003cyour-new-repo\u003e\n\n# Install dependencies\nnpm install\n\n# Configure your app (REQUIRED - sets name, scope, and workspace)\nnpm run configure\n\n# Start development server\nnpm run dev\n```\n\nThe server will start on `http://localhost:8787` serving both your MCP endpoints and the React frontend.\n\n### Prerequisites\n\n- **Node.js ≥22.0.0**\n- **Deco CLI** - Required for development and deployment:\n  ```bash\n  npm install -g deco-cli\n  ```\n- **Deco Account** - Sign up at [admin.decocms.com](https://admin.decocms.com/)\n\n### ⚠️ Important Setup Note\n\nAfter creating your app (via npm create or GitHub template), you must:\n\n1. **Install Deco CLI globally**: \n   ```bash\n   npm install -g deco-cli\n   ```\n\n2. **Login to Deco**:\n   ```bash\n   deco login\n   ```\n\n3. **Configure your app** (REQUIRED before first use):\n   ```bash\n   npm run configure\n   ```\n   \n   This configures:\n   - **App name**: Determines your deployment URL (`\u003capp-name\u003e.deco.page`)\n   - **Scope**: Maps to your deco organization/project\n   - **Workspace**: Maps to your deco organization/project\n\n4. **Deploy** to enable OAuth authentication:\n   ```bash\n   npm run deploy\n   ```\n\n**Note**: The template comes with default values (`name = \"deco-create\"`, `scope = \"kmute\"`). You must run `npm run configure` to set your own values before development or deployment.\n\n## 📁 Project Structure\n\n```\n├── server/           # MCP Server (Cloudflare Workers + Deco runtime)\n│   ├── main.ts      # Server entry point with AI tools\n│   ├── tools/       # Domain-organized AI tools\n│   └── deco.gen.ts  # Auto-generated integration types\n└── view/            # React Frontend (Vite + Tailwind CSS)\n    ├── src/\n    │   ├── lib/rpc.ts    # Typed RPC client for server communication\n    │   ├── routes/       # TanStack Router routes\n    │   └── components/   # UI components with Tailwind CSS\n    └── package.json\n```\n\n## 🛠️ Development Commands\n\n- **`npm run dev`** - Start development with hot reload\n- **`npm run gen`** - Generate types for external integrations  \n- **`npm run deploy`** - Deploy to production\n- **`npm run configure`** - Configure your app and workspace\n\n## 🔗 Frontend ↔ Server Communication\n\nThe template includes a fully-typed RPC client that connects your React frontend to your MCP server:\n\n```typescript\n// Typed calls to your AI tools\nconst result = await client.MY_AI_TOOL({ input: \"data\" });\nconst analysis = await client.ANALYZE_DATA({ dataset: data });\n```\n\n## 🌐 API Integration System\n\nConnect to thousands of services instantly through your [deco project](https://admin.decocms.com/):\n\n- **🤖 AI Services**: OpenAI, Anthropic, Cohere, local models\n- **💳 Payments**: Stripe, PayPal, Square\n- **📧 Communication**: SendGrid, Twilio, Slack\n- **🗄️ Databases**: PostgreSQL, MongoDB, Redis, Supabase\n- **📊 Analytics**: Google Analytics, Mixpanel, Segment\n- **And thousands more...**\n\n### Adding Integrations\n\nAll apps installed in your [deco project](https://admin.decocms.com/) can be used to create new tools or views:\n\n1. **Install apps** in your deco project dashboard\n2. **Run integration**: `npm run configure` or `bun run configure` \n3. **Auto-generated types**: MCP types are downloaded to `shared/deco.gen.ts`\n4. **Start building**: Use the typed clients in your tools immediately\n\nAll integrations come with auto-generated TypeScript types and zero-config setup.\n\n## 🗄️ Integrated Database\n\nEvery deco project includes a **SQLite database with 10GB storage**:\n\n- **Zero setup**: Database is ready to use out of the box\n- **Type-safe ORM**: Built-in Drizzle ORM with TypeScript support\n- **Automatic migrations**: Schema changes are applied automatically\n- **Production ready**: Scales with your application needs\n\nPerfect for storing user data, application state, and business logic without external database setup.\n\n## 🎯 Example Use Cases\n\nBuild powerful AI applications like:\n\n- **📊 Data Analysis Tools**: Connect to databases and APIs to analyze business data with AI\n- **🤖 Customer Support Bots**: Integrate with CRM and support systems for intelligent assistance  \n- **📝 Content Generation**: Combine AI with content management systems and social media APIs\n- **💼 Business Automation**: Create workflows that connect multiple services and automate tasks\n- **🔍 Research Assistants**: Build tools that gather and analyze information from multiple sources\n- **📈 Analytics Dashboards**: Create AI-powered insights from your business data\n\n## 📖 Resources\n\n- **🚀 Get Started**: [Create your first AI app](https://decocms.com/)\n- **📚 Documentation**: [docs.deco.page](https://docs.deco.page)\n- **💬 Community**: [Join our Discord](https://discord.gg/deco)\n- **🐙 Source Code**: [deco-cx/deco](https://github.com/deco-cx/deco)\n\n## 💡 Development Tip\n\nConsider using [SpecStory](https://specstory.com/) in your AI editor to track your development history and prompts as you build your AI application. It's a great way to document your development process and share knowledge with your team.\n\n---\n\n**Ready to build the next generation of AI applications?**\n\n[🚀 **Start Building Now**](https://decocms.com/) • [📖 **Read the Docs**](https://docs.deco.page) • [💬 **Join Community**](https://discord.gg/deco)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecocms%2Fmcp-vtex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecocms%2Fmcp-vtex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecocms%2Fmcp-vtex/lists"}