Skip to main content
Glama
README.md
# 🚀 AR LABS Admin MCP Server

A full-access Model Context Protocol (MCP) server for managing **AR LABS (Viral AI Prompts & Guides)** via AI assistants like Claude Desktop, Cursor, Antigravity IDE, Cline, and Roo Code.

---

## ✨ Features & Tools

With this MCP Server, your AI assistant can:

1. **`create_post`**:
   - Create and publish new AI prompt articles directly to the website.
   - Accepts title, description, prompt text, and thumbnail (as a URL or Base64).
   - Auto-uploads Base64 images to ImgBB.
   - Automatically sends a OneSignal push notification to all subscribers!
2. **`list_posts`**:
   - List all published posts with search filtering and limits.
3. **`get_post`**:
   - Get full details of a specific post including complete prompt text and meta.
4. **`update_post`**:
   - Edit any post's title, description, prompt text, or thumbnail.
5. **`delete_post`**:
   - Delete a post from Firebase Realtime Database.
6. **`upload_image`**:
   - Direct image upload to ImgBB CDN (returns high-speed public CDN URL).
7. **`send_push_notification`**:
   - Send custom broadcast web push notifications to all website subscribers.
8. **`list_comments`**:
   - View user comments across posts.
9. **`delete_comment`**:
   - Moderate and remove spam comments.
10. **`get_site_stats`**:
    - Get quick stats: total posts count, total comments, database status, latest post.

---

## ⚡ Instant Run via NPX

You can run this server anywhere directly from GitHub:

```bash
npx -y github:abdulrehmanfatehali1-ui/ar-labs-mcp-server
```

---

## ⚙️ Configuration Guides

### 1. 🤖 Claude Desktop Configuration
Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ar-labs": {
      "command": "npx",
      "args": [
        "-y",
        "github:abdulrehmanfatehali1-ui/ar-labs-mcp-server"
      ]
    }
  }
}
```

---

### 2. ⚡ Cursor / Antigravity IDE Configuration
In your IDE MCP configuration:

```json
{
  "mcpServers": {
    "ar-labs": {
      "command": "npx",
      "args": [
        "-y",
        "github:abdulrehmanfatehali1-ui/ar-labs-mcp-server"
      ]
    }
  }
}
```

---

### 3. 🛠️ Cline / Roo Code / VS Code Extension
Add under **MCP Servers** settings:
- **Server Name**: `ar-labs`
- **Command**: `npx`
- **Arguments**: `["-y", "github:abdulrehmanfatehali1-ui/ar-labs-mcp-server"]`

TDQS

A3.8/5.0

Scored across 10 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: posts CRUD, comments list/delete, stats, image upload, and push notifications. No overlapping functionality, so an agent can easily select the right tool for a given task.

Naming Consistency5/5

All tool names follow the verb_noun pattern with snake_case (e.g., list_posts, get_post, update_post, delete_post). Retrieval actions use 'get_' for single items and 'list_' for collections, maintaining a consistent and predictable naming scheme.

Tool Count5/5

With 10 tools, the set covers the core admin operations without being excessive or sparse. Each tool serves a specific function relevant to the server's purpose (managing posts, comments, stats, images, and notifications), making the count well-balanced.

Completeness4/5

The tool set provides full CRUD for posts, list/delete for comments, plus stats, image upload, and push notifications. Minor gaps exist, such as no single-comment fetch or comment update action, but the core admin operations are well covered.

Maintenance

ActivitySlowing
ResponsivenessNo issues