Oyster MCP by usefulapi
io.usefulapi/oyster · v1.2.0 · MCP 2025-11-25
Read team, time off, expenses and invoices; approve or decline time off and expenses in Oyster.
Reachability
reachable
checked 2026-11-21 05:37 UTC
Registry status active
Tools pinned 20
fd898baf086a
Tools last changed
unchanged since first capture 2026-11-15
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Website
https://usefulapi.io/oyster/
Remote endpoints
https://oyster.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-15 05:30 | first capture | 20 tools pinned |
Pinned tool definitions (20)
| Tool | Description |
|---|---|
| oyster_get_company | The connected Oyster company: id, name, registration number and corporate/billing addresses. GET /v1/company. |
| oyster_list_team_members | List the company's team members (Oyster engagements: EOR employees, contractors, payroll team members) with name, role, type, state, country, start date, department and work email. Private details (date of birth, addresses, phones,... |
| oyster_get_team_member | One team member (engagement) with employment or contract details, department, benefits and terminations. Salary only with include_compensation; date of birth, addresses, phone numbers and citizenships only with include_personal_details.... |
| oyster_list_departments | List the company's departments with their description and number of team members. GET /v1/departments. |
| oyster_list_time_off_requests | List time off requests with person, dates, type, state, reason and comments, optionally for some team members only. GET /v1/time_off/requests. |
| oyster_get_time_off_request | One time off request with dates, day durations, hours, state, type, reason, comments and attachment. GET /v1/time_off/requests/{id}. |
| oyster_list_time_off_balances | Time off entitlements per team member, in days: annual entitlement, accrued, carried over, adjusted, taken, available, upcoming and projected balance. GET /v1/time_off/entitlements. |
| oyster_list_public_holidays | Public holidays between two dates (up to two years ahead) for a country (ISO code, optional subdivision) or for a team member's location. GET /v1/public_holidays. |
| oyster_list_expenses | List team members' expenses with amount, category, dates, review state (UNREVIEWED, APPROVED, DECLINED) and receipt link. Search by name and filter by review state. GET /v1/expenses. |
| oyster_get_expense | One expense with amount, receipt amount, category, dates, review state, receipt link and team member. GET /v1/expenses/{id}. |
| oyster_list_contract_changes | List contract change requests for all team members (position, compensation, bonus, allowance changes) with state, effective date, requester and the changes. GET /v1/contract_changes. |
| oyster_get_contract_change | One contract change with the requested changes, state, dates, team member and amendment documents. GET /v1/contract_changes/{id}. |
| oyster_list_invoices | List the company's Oyster invoices with type, status, payroll month, issue and due dates, amount, charge (payment) status and payout status. Filter by payroll period, issue date, type, status, charge status or team member. GET /v1/invoices. |
| oyster_get_invoice | One invoice by ID or reference code, with line items, tax, applied credit, charge, payout and document links. GET /v1/invoices/{identifier}. |
| oyster_list_time_sheets | List time sheets with team member, period, cadence, status (PENDING_SUBMISSION, SUBMITTED, PENDING_APPROVAL, APPROVED) and worked/time-off totals. GET /v1/time_tracking/time_sheets. |
| oyster_get_time_sheet | One time sheet with totals, work summary, time off days and the daily entries. GET /v1/time_tracking/time_sheets/{id}. |
| oyster_approve_time_off_request | WRITE: approve a pending time off request. Only on the user's explicit request; check the request with oyster_get_time_off_request first. Needs the manage scope. POST /v1/time_off/requests/{id}/approve. |
| oyster_reject_time_off_request | WRITE: reject a pending time off request with a reason the team member sees. Only on the user's explicit request. Needs the manage scope. POST /v1/time_off/requests/{id}/reject. |
| oyster_approve_expense | WRITE: approve an unreviewed expense for reimbursement. Only on the user's explicit request; check it with oyster_get_expense first. Needs the manage scope. POST /v1/expenses/{id}/approve. |
| oyster_decline_expense | WRITE: decline an unreviewed expense, optionally with a reason the team member sees. Only on the user's explicit request. Needs the manage scope. POST /v1/expenses/{id}/decline. |
Get alerted when this changes.
Email the moment io.usefulapi/oyster drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/oyster)
Maintain this server? Add the badge to your README. It links your users to this live status page.