Oyster Connector for AI agents.
15 live capabilities
Manage global HR, payroll, and compliance through conversational queries.
Waiting for input…
Why people use Oyster
Oyster for Global HR and Payroll Management
This Oyster MCP lets you just ask. You can pull engagement details or check invoice statuses right in your chat. You get a clear view of your global operations without ever leaving your workspace.
What Vinkius changes
You get a conversational interface for your entire global HR and payroll workflow.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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.
- Real-world use case 02
Expense Auditing
A finance lead asks the agent to find all expenses from last month that are still pending review.
- Real-world use case 03
Hiring Planning
An ops lead wants to know if they can hire in Brazil and asks for a list of supported hiring countries.
Complete set · 15capabilities
The complete Oyster capability set.
These are the exact actions your AI can choose when you ask it to work with Oyster.
01—04
4 capabilities in this set.
Part of 15 available through Oyster.
- 01 Capability
Get engagement
Fetch the full details for a specific team member's engagement. Use this to see their specific contract terms.
- 02 Capability
Get expense
Get the specific details of an individual expense. It's great for checking the status of a single reimbursement.
- 03 Capability
Get operation status
Check the status of any async operations. Use this to see if a draft employment or expense has finished processing.
- 04 Capability
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.
05—08
4 capabilities in this set.
Part of 15 available through Oyster.
- 05 Capability
List engagements
Get a full list of all engagements in your account. Use this to see your entire global workforce at a glance.
- 06 Capability
List expenses
Pull a list of all expenses. Use this to audit recent spending across the company.
- 07 Capability
List hiring countries
See which countries and subdivisions you can hire in. This is a beta capability for planning global expansion.
- 08 Capability
List invoices
Get a list of all company invoices. It helps you track payments across different payroll periods.
09—12
4 capabilities in this set.
Part of 15 available through Oyster.
- 09 Capability
List subdivisions
See specific subdivisions for a country. This is a beta capability for granular hiring planning.
- 10 Capability
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.
- 11 Capability
Create webhook
Set up a new webhook endpoint for real-time updates. Use this to get notified when specific events happen in Oyster.
- 12 Capability
Create draft employment
Create a draft employment record for a new hire. This is an async operation that handles the initial setup.
13—15
3 capabilities in this set.
Part of 15 available through Oyster.
- 13 Capability
Create expense
Submit a new expense request with receipt metadata. This capability returns an operation key for tracking.
- 14 Capability
Create time off request
Submit a new vacation or sick leave request for a team member. It handles the request creation in one go.
- 15 Capability
Get company
Pull high-level company details. It's the quickest way to see your core organization info.
Set up in minutes
One URL. Then ask Oyster to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Oyster from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Oyster, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Oyster for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Oyster URL.
- Step 03
Save and start
Save the connection and enable Oyster in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"oyster": {
"url": "https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Oyster
Open Agent mode in chat and ask: "Using Oyster, help me...". 15 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"oyster": {
"url": "https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Oyster
Ask Copilot: "Using Oyster, help me...". 15 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"oyster": {
"url": "https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Oyster
Open Cascade and ask: "Using Oyster, help me...". 15 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"oyster": {
"url": "https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Oyster
Ask Cline: "Using Oyster, help me...". 15 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add oyster --transport http "https://edge.vinkius.com/vk_preview_hnlUPaeyiMjOjDcKUeoQsJOYv4JsTtRA9Uuubg3s/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Oyster
Ask Claude: "Using Oyster, show me...". 15 tools are ready
Where the request belongs
Work Oyster can move forward.
This is for HR managers and finance leads who are tired of clicking through complex dashboards to find basic team data. It solves the pain of manual data entry and the friction of switching between multiple HR capabilities.
HR Manager
Checks time-off balances and engagement details for a distributed team without leaving the chat.
Finance Specialist
Audits company expenses and pulls invoice statuses during month-end reporting.
Operations Lead
Checks hiring availability in different countries before starting new recruitment cycles.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsSmartHR
Empower your AI to manage employee records, organizational structures, and payrolls directly from your SmartHR workspace.
Deel
Manage global contracts, team members, invoices, payments, time-off, and expenses. global HR for AI agents.
Gusto
Manage employees, run payroll, view benefits and time-off policies. HR automation for AI agents.
BambooHR
Human Resources management platform. organize employee data, track time off, and audit HR workflows via AI.
Talexio
Manage HR and payroll for Mediterranean businesses with employee onboarding, leave tracking, and local compliance built in.
BrioHR
Orchestrate BrioHR management. retrieve employee profiles, monitor leave, and integrate claim reports directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Oyster connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Oyster.
The practical details behind the request, access and result.
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 capability. 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 capability. 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 capability with the operation key provided during creation to check its progress.
One connection away
Give your agent a direct line to Oyster.
Connect Oyster once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available