Overview
The Nursa connector links your Nursa facility account to an AI assistant. The assistant can then read your schedule and help you staff open shifts.
The connector works with AI assistants that support remote MCP servers, for example Claude, Claude Code, and ChatGPT. It is for facility users only. Clinician accounts cannot use it.
The assistant cannot post, change, or cancel a shift without your approval. Before each of these actions, it shows you the details and waits for your confirmation.
Before you start
Make sure that you have these items:
- A Nursa facility account.
- Permission to post shifts at the facility, if you want to post shifts. Without this permission, you can only read the schedule.
- An account for an AI assistant that supports remote MCP servers. The connector does not need a specific plan.
If your organization controls which connectors its members can use, an organization Owner must add Nursa first.
Connect
Select your AI assistant.
Use these steps on the web, the desktop app, or the mobile app.
- In Claude, open Settings > Connectors.
- Select Browse connectors.
- Find Nursa and select Connect.
- Sign in with your Nursa account.
- Approve the access request.
You can also connect directly from the Nursa Connector Page
After you connect on one device, the connector is available on all your Claude apps.
- In a terminal, run this command:
claude mcp add --transport http nursa https://mcp.nursa.com/mcp/nursa - Start Claude Code and type
/mcp. - Select nursa and sign in with your Nursa account.
- In ChatGPT, open the apps directory.
- Find Nursa and select Connect.
- Sign in with your Nursa account.
- Approve the access request.
Add a remote MCP server with this URL. The transport is Streamable HTTP.
https://mcp.nursa.com/mcp/nursaThe client gets the sign-in settings from the server automatically. Sign in with your Nursa account when the client asks.
What you can do
- See the facilities that you belong to.
- Review upcoming shifts and past shifts.
- Find open shifts that start soon.
- Get a quote for new per diem shifts or for a block of shifts.
- Post the shifts that you approve.
- Change the bonus or the instructions of a posted shift.
- Cancel a posted shift or a block.
- Request a PBJ export or a clinician work history export by email.
Example prompts
- "What shifts do we have scheduled next week?"Shows the schedule. Reads data only.
- "Which open shifts start in the next 48 hours?"Finds coverage gaps. Reads data only.
- "Post three CNA night shifts for this weekend."Gets a quote, shows it, and posts after you approve.
- "Set up a block of RN day shifts for the first two weeks of next month."Gets a quote for a block and posts after you approve.
- "Add a $50 bonus to tomorrow's open RN shift."Shows the change and updates after you approve.
- "Request the PBJ export for last quarter."Sends the file to your email after you approve.
How posting works
The assistant uses the same sequence each time that it posts a shift:
- You choose the facility.
- The assistant reads the scheduling settings of the facility.
- The assistant gets a quote from Nursa. The quote shows the rates and the estimated total for each shift.
- You review the quote.
- You approve the exact shifts.
- The assistant posts the shifts and gives you a link to each shift in Nursa.
The assistant posts only the shifts in the quote that you approved. If you change a detail, the assistant gets a new quote.
Tools
The connector gives the assistant these 12 tools. Read tools do not change data. Write tools change data, and the assistant asks for your approval first.
| Tool | Type | What it does |
|---|---|---|
List my facilitieslist_my_facilities | Read | Shows the facilities that you belong to, with the name and the state of each facility. |
List facility shiftslist_facility_shifts | Read | Shows a summary of the shifts at your facilities. You can filter by date and by status. Each page shows 25 shifts. |
Get shift detailsget_facility_shift | Read | Shows the full details of one shift, with the bill rate and the bonus. |
Get facility settingsget_facility_settings | Read | Shows the scheduling defaults, the pricing model, and the payment method of a facility. |
Quote shiftsquote_shifts | Quote | Calculates the rates and the estimated total for proposed shifts. It does not post shifts. |
Post per diem shiftscreate_per_diem_shifts | Write | Posts per diem shifts from a quote that you approved. |
Post block shiftscreate_block_shifts | Write | Posts a block of shifts for one clinician. Nursa posts all shifts of the block, or none. |
Request PBJ reportrequest_pbj_report | Write | Sends a PBJ export or a clinician work history export to your email. The file does not show in the chat. |
Update shiftupdate_facility_shift | Write | Changes the bonus or the instructions of one posted shift. |
Update shift blockupdate_facility_block | Write | Changes the bonus or the instructions of a block. The bonus is a total for the block. Nursa divides it between the open shifts and the upcoming shifts. |
Cancel shiftcancel_facility_shift | Destructive | Cancels one posted shift. A late cancellation can cause a fee. The assistant tells you before it cancels. |
Cancel shift blockcancel_facility_block | Destructive | Cancels all remaining shifts of a block. |
Some tools can be unavailable for your account. In this case, the assistant does not show them and tells you to use the Nursa app.
Security and data
This section is for IT admins who decide if their organization can use the connector.
Sign-in and access
- Users sign in with their own Nursa account. Sign-in uses OAuth 2.0 with PKCE.
- The AI assistant does not receive the Nursa password of the user.
- The connector acts as the signed-in user. It can see only the facilities that the user belongs to.
- Nursa checks the facility role of the user on each tool call. A user without permission to post shifts cannot post shifts.
- Each tool call uses a short-lived Nursa token for that call only.
Permission scopes
| Scope | Gives access to |
|---|---|
facilities:read | Read the facilities of the user. Request PBJ exports. |
shifts:read | Read shifts and facility settings. Get quotes. |
shifts:write | Post, change, and cancel shifts. |
Controls
- Approval: each write action needs an explicit approval from the user. Nursa records the time of the approval.
- Rate limits: each user can make 60 read calls and 10 write calls each minute, for each AI app.
- Audit log: Nursa records each tool call with the tool, the user, the AI app, and the time.
Data that the connector returns
- Facility names, IDs, and states.
- Shift dates, times, license types, statuses, rates, bonuses, and instructions.
- Facility scheduling settings and the payment method type.
- Links to shifts in the Nursa app.
Protected health information (PHI). The connector can return data that contains PHI. New tools can also return clinician data, such as names and credentials.
Before you approve the connector for your organization, make sure that your policies let users share PHI with your AI provider.
Limits
- On a posted shift, you can change only the bonus and the instructions.
- To change the date, the time, the role, or the rate of a posted shift, cancel the shift and post it again.
- PBJ exports go to your email. They do not show in the chat.
- The connector can use only the facilities that you belong to.
- The connector does not report clinician no-shows. Use the shift report in the Nursa app.
Troubleshooting
When a problem occurs, the assistant usually tells you a probable cause. These are examples of problems that you can see:
- A facility does not show in the list.
- You are not a user of that facility in Nursa. Ask an admin of the facility to add you.
- Nursa does not let me post a shift.
- You do not have permission to post shifts at that facility. Ask an admin of the facility to give you this permission.
- The assistant says that an action is not available.
- That tool is not available for your account. Use the Nursa app for that action.
- The sign-in does not complete.
- Disconnect the connector. Then connect again and sign in with your Nursa facility account. Do not use a clinician account.
- The assistant says that there are too many requests.
- You reached the rate limit. Wait one minute and try again.
- The quote is no longer valid.
- Ask the assistant to get a new quote. Then review it and approve it again.
Disconnect and remove access
Disconnect your account
- In Claude, open Settings > Connectors.
- Select Nursa.
- Select Disconnect.
In a terminal, run this command:
claude mcp remove nursa- In ChatGPT, open the settings for apps.
- Select Nursa.
- Select Disconnect.
Remove the Nursa server from the settings of your MCP client.
Remove the access of a user (Nursa admins)
To stop the access of a user from the Nursa side, remove the user from the facility in the Nursa app. This is the only way to remove access from the Nursa side.
- In the Nursa app, open Facilities.
- Select the facility.
- Open Users.
- Select the user.
- Select Unassign from Unit.
Do these steps for each facility that the user belongs to. The next tool call from that user for the facility fails, in all AI apps.