# Oases MCP by usefulapi

> Oases MCP by usefulapi is an MCP server. Read students, parents, sessions and invoices; add notes and update fields in Oases. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/oases/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/oases
- **MCP Registry name:** io.usefulapi/oases
- **Listing updated:** 2026-11-13

## About

Read students, parents, sessions and invoices; add notes and update fields in Oases.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http oases https://oases.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://oases.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oases": {
      "url": "https://oases.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oases": {
      "type": "http",
      "url": "https://oases.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oases": {
      "serverUrl": "https://oases.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oases": {
      "type": "http",
      "url": "https://oases.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `oases_get_student`: Get one student record by id. Oases API: GET /v2/student/{id}.
- `oases_get_parent`: Get one parent record by id. Oases API: GET /v2/parent/{id}.
- `oases_get_staff`: Get one staff member record (tutor or staff) by id. Oases API: GET /v2/staff/{id}.
- `oases_get_session`: Get one tutoring session record by id. Oases API: GET /v2/session/{id}.
- `oases_get_invoice`: Get one invoice by id, with its line items. Oases API: GET /v2/invoice/{id}.
- `oases_get_payment`: Get one payment record by id. Oases API: GET /v2/payment/{id}.
- `oases_get_notes`: List the notes on one student, parent or tutor, or schedule. Oases API: GET /v2/note/{note_type}/{note_parent}.
- `oases_get_list`: Read one reference list, such as states, schools, grades, session types or custom fields. Oases API: GET /v2/lists/{name}.
- `oases_create_note`: Add a note to a student, parent or tutor, or schedule. This creates a new record each time it runs. Oases API: PUT /v2/note (form data).
- `oases_update_student`: Change one field of a student record. Oases API: POST /v2/student/{id} with fieldname and value.
- `oases_update_parent`: Change one field of a parent record. Oases API: POST /v2/parent/{id} with fieldname and value.

## FAQ

### How do I add Oases MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http oases https://oases.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/oases-mcp-by-usefulapi
