# Cobot MCP

> Cobot manages coworking spaces through natural language interaction. This MCP lets you track member memberships, monitor resource availability (desks, rooms), process bookings, and review billing invoices—all from your AI agent without opening the dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** coworking-management, membership-tracking, resource-booking, billing-automation, workspace-management, member-portal

## Description

Managing a large workspace used to mean jumping between three different tabs: the membership portal, the booking calendar, and the finance system. This MCP connects those functions into one conversation. You tell your AI client what you need—like 'Show me who needs an invoice for this month' or 'Book a conference room for next Tuesday.' Your agent handles the complex checks in the background. It lists active members, verifies which plans they have, and immediately tells you if a resource is free during that timeframe. If everything lines up, it books it right away. This level of control over physical space logistics is what Vinkius makes possible by hosting this connection.

## Tools

### create_new_booking
Schedules a reservation for a specific resource (like a desk or room).

### get_membership_details
Fetches comprehensive information for a single, specific member account.

### get_cobot_space_info
Retrieves basic details and metadata about the entire coworking facility.

### list_space_bookings
Shows a list of resource reservations that happened within a defined date range.

### list_cobot_invoices
Generates a list of all membership invoices and shows their payment status.

### list_cobot_memberships
Retrieves an overview of every active member account in the space.

### list_membership_plans
Lists all available membership types and pricing plans for comparison.

### list_space_resources
Lists every type of bookable item, such as meeting rooms and dedicated desks.

## Prompt Examples

**Prompt:** 
```
List all active memberships in my coworking space.
```

**Response:** 
```
Retrieving active memberships... I found 25 members across various plans: 10 'Full-time Desk', 12 'Part-time 10 Days', and 3 'Enterprise Suites'. Would you like the details for any specific member?
```

**Prompt:** 
```
Show me the bookings for 'Large Meeting Room' for this week.
```

**Response:** 
```
Checking bookings for the Large Meeting Room... There are 4 reservations this week: Monday at 10 AM, Wednesday at 2 PM, and two on Friday morning.
```

**Prompt:** 
```
Are there any unpaid invoices from last month?
```

**Response:** 
```
Checking account history... I found 2 unpaid invoices from last month for members 'Sarah Smith' and 'Global Tech'. All other memberships are in good standing.
```

## Capabilities

### Check Membership Status
Retrieves a complete list of all current members and their associated plan details.

### Verify Resource Availability
Lists which desks, meeting rooms, and other physical assets are bookable within specific date ranges.

### Create New Reservations
Schedules a booking for any available resource directly from your chat interface.

### Audit Billing Records
Generates reports on member invoices, including payment status and outstanding balances.

### View Space Metadata
Gathers core operational information about the specific coworking space it manages.

## Use Cases

### Checking Member Eligibility
A Community Coordinator needs to know if a member can book an executive suite. They ask their agent, and the MCP uses get_membership_details first to confirm the plan level before checking list_space_resources for availability.

### Auditing Overdue Accounts
An Accountant needs a quick overview of who owes money. They ask the agent, and it runs list_cobot_invoices, showing all unpaid records from last month instantly.

### Handling Last-Minute Bookings
A Space Manager hears about an unexpected meeting. The agent checks list_space_bookings for the next few days and, finding a gap, uses create_new_booking to secure the resource immediately.

### Pre-Event Readiness Check
An Ops Team member prepares for an event by asking the agent to list_space_resources. It confirms all necessary items—from whiteboards to extra desks—are configured and available.

## Benefits

- Stop clicking between systems. You can check membership details and immediately see if that member is eligible to book a resource, all in one query.
- Streamline billing processes by calling list_cobot_invoices; you instantly get payment status for multiple members without running reports.
- Bookings are simple. Use create_new_booking to reserve a room or desk directly from your agent's response to a chat prompt.
- Never wonder what resources exist again. The list_space_resources tool gives you a real-time inventory of every bookable item, like desks and meeting rooms.
- Need an audit? You can use list_cobot_memberships to get the full roster, then cross-reference it with list_space_bookings for resource utilization reports.

## How It Works

The bottom line is you talk to your AI client, and it uses this MCP to handle the complex data retrieval and action steps in the background.

1. Subscribe to this MCP and input your Cobot Access Token along with the space subdomain.
2. Connect your preferred AI client (like Claude or Cursor) through Vinkius, granting it permission to access the tools.
3. Ask a natural language question—for example, 'List all members on the basic plan who haven't paid their invoices.' — and the agent executes the required actions.

## Frequently Asked Questions

**How do I check if resources are available using list_space_resources?**
You run list_space_resources first to get a full inventory of every bookable item, like desks and meeting rooms. This lets you know what options exist before checking availability for specific dates.

**What is the difference between list_membership_plans and list_cobot_memberships?**
list_membership_plans shows all possible pricing tiers available in your space. list_cobot_memberships, by contrast, lists every actual person who holds a current membership.

**Can I book something without listing the resources first? (create_new_booking)**
You can't. The agent needs to know exactly what you want to reserve. It runs list_space_resources internally and uses that data context when calling create_new_booking.

**How do I check for overdue payments using list_cobot_invoices?**
list_cobot_invoices pulls all invoices into your chat. You can then filter the results by 'payment status' to immediately see which memberships are outstanding.

**If I need specific member information, how do I use `get_membership_details`?**
You must provide a unique membership ID for this tool to work. This function pulls all data—contact info, plan status, and history—for one account only. It doesn't search by name; the ID is required.

**What information does `get_cobot_space_info` provide about my location?**
This tool gives you core metadata for your entire facility. You retrieve essential details like the space's official name, overall capacity, and key operational settings without needing to log into a dashboard.

**Does `create_new_booking` prevent me from double-booking a resource?**
Yes, the booking creation tool validates availability first. If the requested date or time slot is already reserved, the API will return an error code and won't create the conflict.

**Can I filter resources when I run `list_space_resources`?**
You can specify parameters like resource type. This lets you quickly pull lists of only 'desks' or only 'conference rooms', making your data retrieval highly focused.

**Can I see who has booked a specific meeting room today?**
Yes! Use the `list_space_bookings` tool with today's date range. The agent will return all bookings, allowing you to see which members have reserved specific rooms.

**How do I check the status of a member's last invoice?**
Use the `list_cobot_invoices` tool. Your agent will fetch all invoices, and you can filter for a specific member's name or ID to see if their last payment was successful.

**Where do I find my Cobot Access Token and Subdomain?**
The **Subdomain** is the first part of your Cobot URL (e.g., `myspace` in `myspace.cobot.me`). You can generate an **Access Token** via the Cobot developer portal or by creating an application in your account settings.