Oyster MCP for AI. Manage global HR and payroll from conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
How this MCP server connects to your AI agent
Oyster manages global HR, payroll, and compliance data directly from your agent. Check time-off requests for a distributed workforce, track expenses, review invoices, or draft new employment records—all without logging into the Oyster dashboard.
What AI agents can do with Oyster Automation
Create draft employment
Drafts a preliminary employment record, useful when planning a future hire.
Create expense
Submits a new expense report for review by the finance team.
Create time off request
Files a formal request for employee leave (vacation or sick time).
View the status of current leave applications or submit new vacation and sick day requests.
List existing expense reports, check their review status, or pull company invoice records by payroll period.
See all active team engagements globally or fetch specific metadata for a single user.
Retrieve lists of supported countries and subdivisions to determine where you can hire next.
Ask an AI about this
Waiting for input…
What AI agents can do with Oyster: 15 Tools Available
Use these tools to read data or perform actions within your company's Oyster HR system via natural conversation.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Oyster on VinkiusCreate Draft Employment
Drafts a preliminary employment record, useful when planning a future hire.
Create Expense
Submits a new expense report for review by the finance team.
Create Time Off Request
Files a formal request for employee leave (vacation or sick time).
Create Webhook
Sets up an endpoint to receive real-time updates from Oyster.
Get Company
Retrieves general details about the company account.
Get Engagement
Fetches specific, detailed records for one employee's current engagement period.
Get Expense
Retrieves all the details associated with a single expense report ID.
Get Operation Status
Checks if an asynchronous process, like creating an account, has finished or failed.
Get Time Off Request
Gets the full status and details for a specific time-off request ID.
List Engagements
Provides an overview list of all current employee engagements in the company.
List Expenses
Returns a comprehensive list of expense reports, allowing filtering by status or...
List Hiring Countries
Lists all countries where the company is currently allowed to hire staff.
List Invoices
Pulls a list of company invoices, letting you filter by payment status or payroll period.
List Subdivisions
Lists smaller administrative areas within a specific country for global planning.
List Time Off Requests
Retrieves an overview of all time-off requests, allowing you to see who needs leave...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Oyster integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Oyster, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Oyster. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 15 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The constant headache of global team management, Solved with Vinkius AI Gateway
Today, managing an international workforce means jumping between the internal dashboard, the payroll portal, and the expense system. You have to manually copy engagement IDs into one place, check leave statuses in another, and then cross-reference invoices by hand just to confirm who's paid what for which quarter.
With this MCP, your agent handles that entire flow conversationally. Instead of copying and pasting data across five different tabs, you ask: 'What is the status of expenses for Q2?' and get a single, consolidated list back.
Oyster gives you immediate access to global records
You eliminate the need to manually check if an employee's current engagement details are accurate before processing pay. You also stop spending time confirming country support by checking multiple government websites—all that data is available instantly.
What changes now is your ability to act on complex HR rules without ever leaving your conversation window. It’s immediate, verifiable action.
What your AI can actually do with this
Managing an international team means juggling payroll rules, local labor laws, and disparate systems. This MCP connects your AI client to your Oyster account, letting you handle complex global HR tasks using natural conversation. Instead of jumping between dashboards to check balances or submit expense reports, you ask your agent directly.
Need to know if a country supports hiring? Check the list of supported nations. Want to approve leave? Monitor and create time-off requests for every employee, regardless of where they live. This integration gives HR managers and finance teams immediate access to core data—from checking invoice statuses to listing active team engagements.
With Vinkius, you connect this power source once, giving your agent a single point of contact for all global workforce management needs.
019ea6d4-f5d4-7340-92cf-86f192bab3e9 
Here's how it actually works
The bottom line is that your AI client acts as a natural language gateway to complex HR records that used to require multiple dashboard logins.
Subscribe to this MCP, then provide your Oyster Personal Access Token within your AI client.
Tell your agent exactly what task you need done—for example, 'Show me all pending expense reports for Q2.'
The agent executes the necessary action and delivers the requested data or confirms the request's status.
Who is this actually for?
Anyone managing a team across different countries needs this. It’s for the HR Manager tired of manually cross-referencing time sheets with payroll data, and the Finance Lead who wastes hours pulling invoice reports from various portals.
Needs to quickly verify an employee's current leave balance or check if a proposed new location is supported for global hiring.
Must audit expense reports, query invoice statuses by payroll date, and confirm engagement details for tax purposes.
Uses it to monitor the status of asynchronous hiring operations or create draft employment records for new hires.
What Changes When You Connect
Audit finances faster. Instead of navigating to the invoicing section, you can simply ask your agent to list invoices filtered by a specific payroll period or status.
Handle leave in bulk. Use list_time_off_requests and get_time_off_request to see who needs approval across your entire global staff instantly, without opening multiple employee profiles.
Improve compliance visibility. List engagements gives you a full view of active employment details for every team member globally, ensuring all records are up-to-date.
Streamline hiring prep. Before planning expansion, use list_hiring_countries and list_subdivisions to confirm local availability and setup requirements in one go.
Track money movement easily. You can query existing expenses using get_expense or check the status of an expense report by calling list_expenses.
See it in action
The Quarterly Audit
A finance manager needs to reconcile all payroll costs for a specific quarter. Instead of downloading reports from multiple tabs, they ask their agent to list_invoices filtered by the date range and status. This immediately provides an accurate, auditable list for compliance review.
The Global New Hire
An operations lead is planning a team expansion into Vietnam. They first use list_hiring_countries to check availability, then list_subdivisions to find the correct regional office code before calling create_draft_employment.
The Leave Approver
An HR manager needs to process 15 leave requests. Instead of opening 15 profiles, they use list_time_off_requests and then get_time_off_request on the specific ID to confirm approval status for each person.
The Expense Follow-Up
An employee submits an expense report that seems stuck. The manager uses list_expenses to see the report and then get_expense to check exactly which step it's stalled on, allowing for quick follow up.
The honest tradeoffs
Checking a single employee record
Asking 'What is John Doe’s status?' and only receiving one data point. This forces the user to manually check multiple reports for full context.
Don't rely on single queries. Use list_engagements to get an overview, then use get_engagement with the specific ID if you need deep metadata.
Submitting expenses without details
Calling create_expense and only providing a receipt photo, failing to specify which payroll period or department it belongs to.
Always provide context. Use list_expenses first to confirm the correct review state, then call create_expense with all necessary metadata.
Trying to find global support for a country
Asking generally 'Is France supported?' without knowing if it's an office or just a subdivision.
First, run list_hiring_countries. If France appears, use list_subdivisions to get the detailed regional code needed for accurate record keeping.
When It Fits, When It Doesn't
Use this MCP if your primary need is transactional HR data: tracking payroll, managing time off, or filing expense reports. This tool excels at reading and writing records related to employee status and finance. Don't use it if you only need general organizational structure information that isn't tied to a financial record; for instance, if you just want a list of every department name without knowing who works there, this MCP is overkill. If your goal is pure directory lookups or accessing external departmental wikis, you should use a different type of connector—one designed specifically for documentation retrieval rather than action-based HR records.
Questions you might have
How do I list all active engagements using the Oyster MCP? +
You use list_engagements. This tool provides an overview of every current team member's employment status and engagement details across your global organization.
Can I check if a new country is supported for hiring with Oyster MCP? +
Yes, you first run list_hiring_countries to see all options. If the country is listed, you can then use list_subdivisions to get precise regional details.
What if I need to check a specific time off request? Do I use Oyster MCP? +
Yes. You should first run list_time_off_requests for an overview, and then use get_time_off_request with the ID number to pull up all granular details.
Is creating a draft employment immediate or does it take time? +
create_draft_employment is marked as an asynchronous operation. This means you send the request, and the system will update its status over time; you must use get_operation_status to track progress.
How does Oyster MCP handle expense report creation? +
You initiate it using create_expense. Remember that this is also an asynchronous process, so the request key will be returned for later status checks.
We've already built the connector for Oyster. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 15 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.