# Oyster MCP for AI Agents AI Agent Connect

> Oyster MCP lets you manage your global workforce from your AI agent. You can pull engagement details, track expenses, handle time-off requests, and check hiring eligibility across different countries. It's about getting your HR and payroll data without switching tabs.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/ai-agent-connect
- **Tags:** global-hr, payroll, compliance, expense-management, time-off-tracking

## Description

Managing a distributed team usually means jumping between different tabs to check who's on vacation, who's getting paid, and where you're actually allowed to hire. This Oyster MCP changes that by letting your AI agent handle the heavy lifting. Instead of hunting through a dashboard, you can just ask your agent to list active engagements or pull up specific invoice statuses. If you need to start a new hire process, you can create a draft employment or check which countries your company can actually hire in. It handles the tedious stuff like tracking expenses and monitoring time-off requests so you can stay focused on the actual work. It's a big part of what makes the Vinkius catalog so useful for HR teams who need to move fast. You get a clear picture of your global operations through a simple conversation. You don't have to worry about remembering specific URLs or navigating complex menus. Whether you're checking on a specific payroll period or looking for a receipt, the information comes to you in plain text. You can also monitor the status of your pending actions or set up webhooks to keep your data fresh without any manual intervention. It's about getting the right info at the right time without the friction of a traditional UI.

## Tools

### get_engagement
Fetch the full details for a specific team member's engagement. Use this to see their specific contract terms.

### get_expense
Get the specific details of an individual expense. It's great for checking the status of a single reimbursement.

### get_operation_status
Check the status of any async operations. Use this to see if a draft employment or expense has finished processing.

### get_time_off_request
Pull the details for a specific time-off request. This helps you see the exact dates and status of a leave request.

### list_engagements
Get a full list of all engagements in your account. Use this to see your entire global workforce at a glance.

### list_expenses
Pull a list of all expenses. Use this to audit recent spending across the company.

### list_hiring_countries
See which countries and subdivisions you can hire in. This is a beta tool for planning global expansion.

### list_invoices
Get a list of all company invoices. It helps you track payments across different payroll periods.

### list_subdivisions
See specific subdivisions for a country. This is a beta tool for granular hiring planning.

### list_time_off_requests
Pull every time-off request in your system. Use this to get a bird's-eye view of who's away.

### create_webhook
Set up a new webhook endpoint for real-time updates. Use this to get notified when specific events happen in Oyster.

### create_draft_employment
Create a draft employment record for a new hire. This is an async operation that handles the initial setup.

### create_expense
Submit a new expense request with receipt metadata. This tool returns an operation key for tracking.

### create_time_off_request
Submit a new vacation or sick leave request for a team member. It handles the request creation in one go.

### get_company
Pull high-level company details. It's the quickest way to see your core organization info.

## Prompt Examples

**Prompt:** 
```
Who is currently on vacation next week?
```

**Response:** 
```
I've pulled the time-off requests for next week. Here's the summary:

| Employee | Type | Dates |
| :--- | :--- | :--- |
| Jane Doe | Vacation | Dec 12 - Dec 15 |
| John Smith | Sick Leave | Dec 13 |

Would you like me to check the status of a specific request?
```

**Prompt:** 
```
Show me all pending expenses from last month.
```

**Response:** 
```
I found 12 pending expenses from last month. Here are the top 5:

* **Office Supplies** - $145.00 (Pending Review)
* **Travel Reimbursement** - $850.00 (Pending Review)
* **Software Subscription** - $200.00 (Pending Review)
* **Client Dinner** - $120.00 (Pending Review)
* **Internet Stipend** - $50.00 (Pending Review)

I can pull the full list for you if needed.
```

**Prompt:** 
```
Can we hire in Japan right now?
```

**Response:** 
```
Yes, Japan is a supported hiring country. Here are the available subdivisions:

* Tokyo
* Osaka
* Kyoto

Would you like me to start a draft employment for one of these locations?
```

## Capabilities

### List active global engagements
Get a full list of your team members and their specific engagement details.

### Track company expenses
Query, filter, and view all company expenses in one place.

### Manage time-off requests
Retrieve or create vacation and sick leave requests for your workforce.

### Review company invoices
Access invoice data filtered by payroll periods or statuses.

### Check hiring eligibility
See which countries and subdivisions are available for new hires.

### Create draft employments
Start the hiring process by creating draft employment records.

### Monitor operation statuses
Track the progress of asynchronous tasks like new hire creations.

## Use Cases

### Checking Leave Balance
An HR manager asks the agent to list all time-off requests for next week to see who's out of the office.

### Expense Auditing
A finance lead asks the agent to find all expenses from last month that are still pending review.

### Hiring Planning
An ops lead wants to know if they can hire in Brazil and asks for a list of supported hiring countries.

### Onboarding
An admin creates a draft employment record for a new hire in Germany using a single prompt.

## Benefits

- Stop tab-switching between your HR dashboard and your chat client by pulling engagement data directly into your conversation.
- Audit company spending faster by using `list_expenses` and `list_invoices` to see everything in one place.
- Speed up hiring by using `list_hiring_countries` to check your expansion options before you start recruiting.
- Handle time-off requests instantly with `create_time_off_request` instead of manual form entry.
- Keep track of long-running tasks like `create_draft_employment` by checking the `get_operation_status` tool.
- Automate your data flow by setting up `create_webhook` to get real-time updates on your HR operations.

## How It Works

The bottom line is you get a conversational interface for your entire global HR and payroll workflow.

1. Subscribe to the Oyster MCP on Vinkius.
2. Provide your Oyster Personal Access Token.
3. Ask your AI client to pull engagement data or create a time-off request.

## Frequently Asked Questions

**Can I use Oyster MCP to manage my global team?**
Yes, it connects your Oyster account to your AI client. This lets you manage your global workforce through a simple chat interface.

**How do I check employee time-off with Oyster MCP?**
You can ask your agent to list all time-off requests or check a specific one. It pulls the dates and status directly from Oyster.

**Can Oyster MCP help with my company's hiring plan?**
Yes, it can list all supported hiring countries and subdivisions. This helps you see where you can expand before you start recruiting.

**Is Oyster MCP good for auditing expenses?**
It lets you list all expenses and pull specific details for every one. You can quickly see what's pending or already approved.

**Can I create new hires using Oyster MCP?**
You can create draft employment records as an async operation. This starts the hiring process for a new team member via your agent.

**How does Oyster MCP handle invoices?**
It can list all company invoices. This allows you to track payments and check statuses across different payroll periods.

**Can I submit a new expense for a team member through the AI?**
Yes! Use the `create_expense` tool. You will need to provide the engagement ID, expense details (name, description, category, date), and the receipt information including the amount and currency.

**How do I check which countries Oyster supports for hiring?**
Simply ask the agent to run the `list_hiring_countries` tool. It will return a list of all countries where Oyster currently facilitates global employment.

**Is it possible to track the status of a request I just created?**
Yes. For asynchronous operations like creating expenses, you can use the `get_operation_status` tool with the operation key provided during creation to check its progress.