Skip to main content
Glama

MCP Art Supply Store

by wspotter
npmGitHub
TypeScript
13
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🎨 MCP Art Supply Store

Model Context Protocol Server with 36 Business Management Tools

TypeScript MCP Node.js

A complete Model Context Protocol (MCP) server for managing an art supply store business with 36 professional tools across 8 categories, plus social media integration.

✨ Features

📦 36 Business Management Tools

🛍️ Inventory Management (5 tools)

  • Add/update/remove products

  • Check stock levels

  • Low stock alerts

  • Track product details

👥 Customer Management (4 tools)

  • Add/update/retrieve customers

  • Customer purchase history

  • Loyalty tracking

  • Contact management

📝 Order Processing (5 tools)

  • Create/update/cancel orders

  • Order status tracking

  • Order history

  • Fulfillment management

💰 Financial Tools (3 tools)

  • Sales reports

  • Revenue tracking

  • Profit analysis

🎨 Art Classes (5 tools)

  • Schedule management

  • Student enrollment

  • Instructor tracking

  • Class capacity monitoring

📊 Analytics (4 tools)

  • Sales analytics

  • Customer insights

  • Product performance

  • Trend analysis

📢 Marketing (3 tools)

  • Campaign management

  • Promotion tracking

  • Customer targeting

🌐 Social Media (12 tools)

  • Facebook post creation

  • Instagram publishing

  • Post scheduling

  • Comment management

  • Analytics tracking

  • Multi-platform support

🎯 Key Capabilities

  • Complete Business Management - All tools for running an art supply store

  • Social Media Integration - Facebook & Instagram via Meta Graph API (FREE)

  • Real-time Analytics - Track sales, customers, and performance

  • Web Dashboard - Beautiful UI for testing and monitoring

  • TypeScript - Type-safe, maintainable code

  • MCP Protocol - Standard Model Context Protocol implementation

🚀 Quick Start

Prerequisites

  • Node.js 18+

  • npm or yarn

  • (Optional) Facebook/Instagram Business accounts for social media features

Installation

# Clone the repository git clone https://github.com/wspotter/mcpart.git cd mcpart # Install dependencies npm install # Build the project npm run build # Configure environment (optional - for social media) cp .env.example .env # Edit .env with your API keys

Running the Server

As MCP Server:

npm start

With Dashboard:

npm run dashboard # Open http://localhost:3000

📖 Documentation

Quick Links

Total: 1,500+ lines of documentation

🛠️ Tool Categories

1. Inventory Management

inventory_add_product inventory_update_product inventory_remove_product inventory_check_stock inventory_list_low_stock

2. Customer Management

customer_add customer_update customer_get customer_list_purchases

3. Order Processing

order_create order_update order_cancel order_get_status order_list

4. Financial Tools

finance_get_sales_report finance_get_revenue finance_get_profit_analysis

5. Art Classes

class_schedule class_enroll_student class_list_students class_get_schedule class_update_instructor

6. Analytics

analytics_sales_trends analytics_customer_insights analytics_product_performance analytics_monthly_report

7. Marketing

marketing_create_campaign marketing_track_promotion marketing_get_customer_segments

8. Social Media (Meta Graph API - FREE!)

social_facebook_create_post social_instagram_create_post social_schedule_post social_get_post_analytics social_reply_to_comment social_get_comments social_delete_post social_update_post social_get_page_insights social_get_instagram_insights social_upload_media social_get_scheduled_posts

🎨 Dashboard

Beautiful web interface for testing and monitoring:

Features

  • 8 Category Navigation - Organized sidebar

  • Tool Cards - Visual tool display with descriptions

  • Real-time Testing - Test any tool with JSON input

  • Search Functionality - Find tools quickly

  • Responsive Design - Works on all devices

  • Dark Theme - Easy on the eyes

Access

npm run dashboard open http://localhost:3000

🌐 Social Media Integration

Facebook & Instagram (FREE!)

Uses Meta Graph API - no cost for basic posting and analytics.

Setup Steps:

  1. Create Facebook App

  2. Get Page Access Token

  3. Configure .env file

  4. Connect Instagram Business Account

  5. Start posting!

See: FACEBOOK_INSTAGRAM_SETUP.md for detailed guide (500+ lines)

Features:

  • Create posts with images

  • Schedule future posts

  • Monitor comments

  • Reply to comments

  • Track analytics

  • Multi-platform (FB + IG)

📊 Example Usage

Add a Product

{ "name": "inventory_add_product", "arguments": { "name": "Acrylic Paint Set", "sku": "APS-001", "quantity": 50, "price": 29.99, "category": "Paint", "supplier": "ArtPro Inc" } }

Create Facebook Post

{ "name": "social_facebook_create_post", "arguments": { "message": "New paint sets just arrived! 🎨", "imageUrl": "https://example.com/paint.jpg", "link": "https://shop.example.com/paint-sets" } }

Check Sales Report

{ "name": "finance_get_sales_report", "arguments": { "startDate": "2025-10-01", "endDate": "2025-10-31" } }

🔧 Configuration

Environment Variables

# .env file # Server PORT=3000 # Meta Graph API (for social media - optional) META_ACCESS_TOKEN=your_page_access_token META_PAGE_ID=your_facebook_page_id META_INSTAGRAM_ACCOUNT_ID=your_instagram_business_account_id # API Version META_API_VERSION=v18.0

MCP Configuration

Add to your MCP client config (e.g., Claude Desktop):

{ "mcpServers": { "art-supply-store": { "command": "node", "args": ["/path/to/mcpart/build/index.js"], "env": { "META_ACCESS_TOKEN": "your_token_here" } } } }

📁 Project Structure

mcpart/ ├── src/ │ ├── index.ts # Main MCP server │ ├── dashboard.ts # Web dashboard server │ └── social-media.ts # Social media manager ├── public/ │ ├── index.html # Dashboard UI │ ├── styles.css # Dashboard styling │ └── script.js # Dashboard logic ├── build/ # Compiled TypeScript ├── docs/ │ ├── TOOLS_DOCUMENTATION.md │ ├── FACEBOOK_INSTAGRAM_SETUP.md │ └── QUICK_REFERENCE.md ├── .env.example # Environment template ├── package.json ├── tsconfig.json └── README.md

🎯 Use Cases

  • Art Supply Stores - Complete business management

  • Retail Shops - Inventory and sales tracking

  • Class Management - Schedule and enrollment

  • Social Media Marketing - Automated posting

  • Business Analytics - Performance tracking

  • Customer Management - Loyalty and history

  • AI Assistants - Give AI tools to manage business

🤝 Contributing

Contributions welcome! Areas for improvement:

  • Additional payment integrations

  • Email marketing tools

  • Advanced analytics dashboards

  • Mobile app

  • More social platforms (Twitter, TikTok)

  • Inventory forecasting

  • CRM features

📄 License

MIT License - free to use in your projects!

🙏 Credits

Built with:

  • MCP TypeScript SDK - @modelcontextprotocol/sdk

  • Meta Graph API - Facebook/Instagram integration

  • Express.js - Dashboard server

  • TypeScript - Type-safe development

🌟 Star This Repo!

If you find this MCP server useful, please give it a ⭐!

📞 Support

🔮 Roadmap

  • 24 core business tools

  • Social media integration (12 tools)

  • Web dashboard

  • TypeScript implementation

  • Meta Graph API integration

  • Additional social platforms

  • Email marketing

  • Advanced analytics

  • Mobile app

  • Multi-store support

📈 Stats

  • 36 Tools across 8 categories

  • 1,500+ lines of documentation

  • TypeScript for type safety

  • Free social media posting

  • Production-ready code

  • Comprehensive error handling

💼 Perfect For

  • Small business owners

  • Art supply stores

  • Retail shops

  • AI assistant developers

  • MCP protocol developers

  • Social media managers

🎉 Get Started

git clone https://github.com/wspotter/mcpart.git cd mcpart npm install npm run build npm run dashboard # Visit http://localhost:3000

Version: 1.0
Tools: 36 professional tools
Status: Production-Ready
Created: October 2025

Made with 💚 for the MCP community!

Transform your AI assistant into a complete business management system! 🎨

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

A comprehensive business management server with 36 tools for running an art supply store, including inventory management, customer tracking, order processing, financial reporting, class scheduling, analytics, marketing, and social media integration with Facebook and Instagram.

  1. ✨ Features
    1. 📦 36 Business Management Tools
    2. 🎯 Key Capabilities
  2. 🚀 Quick Start
    1. Prerequisites
    2. Installation
    3. Running the Server
  3. 📖 Documentation
    1. Quick Links
  4. 🛠️ Tool Categories
    1. 1. Inventory Management
    2. 2. Customer Management
    3. 3. Order Processing
    4. 4. Financial Tools
    5. 5. Art Classes
    6. 6. Analytics
    7. 7. Marketing
    8. 8. Social Media (Meta Graph API - FREE!)
  5. 🎨 Dashboard
    1. Features
    2. Access
  6. 🌐 Social Media Integration
    1. Facebook & Instagram (FREE!)
  7. 📊 Example Usage
    1. Add a Product
    2. Create Facebook Post
    3. Check Sales Report
  8. 🔧 Configuration
    1. Environment Variables
    2. MCP Configuration
  9. 📁 Project Structure
    1. 🎯 Use Cases
      1. 🤝 Contributing
        1. 📄 License
          1. 🙏 Credits
            1. 🌟 Star This Repo!
              1. 📞 Support
                1. 🔮 Roadmap
                  1. 📈 Stats
                    1. 💼 Perfect For
                      1. 🎉 Get Started

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/wspotter/mcpart'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server