ALIS MCP Connector

Connect Claude to your ALIS account and ask about your communities and residents in plain language.

The ALIS MCP Connector lets Claude and other AI assistants read data from your organization's ALIS account. You sign in with your own ALIS account, and the assistant only sees what your ALIS permissions allow. The connector is read-only: it can look data up, but it cannot create, change or delete anything in ALIS.

Requirements

An active ALIS account. You sign in with the same account you use for ALIS.
The ALIS MCP Connector turned on for your organization. ALIS turns it on on request: contact your ALIS account manager or ALIS support. Until it is on, sign-in shows "Your company has not turned on the ALIS MCP Connector".
An MCP client that supports remote MCP connectors with sign-in, such as Claude.ai, Claude Desktop, Claude Code, ChatGPT, Codex or Copilot.

Getting started

Claude.ai and Claude Desktop

Open Settings → Connectors.
Find ALIS in the directory and click Connect. If ALIS is not listed yet, choose Add custom connector and paste the server URL: https://mcp.alisonline.com/mcp.
Your browser opens the ALIS sign-in page. Sign in with your ALIS account and approve access.
In a chat, click + → Connectors and turn on ALIS.

On Claude Team and Enterprise plans, an organization owner must add the ALIS connector before members can connect their own ALIS accounts.

Claude Code

Add the server:

claude mcp add --transport http alis https://mcp.alisonline.com/mcp

Run /mcp, select alis, and finish the sign-in in your browser.
Check it is connected with claude mcp list.

Other AI apps

Follow your app's steps for adding a remote MCP server. Use https://mcp.alisonline.com/mcp with the Streamable HTTP transport. Your app must support OAuth sign-in.

Check that it works

Ask: "Which ALIS communities do I have access to?" Claude should list your communities. If it does, you're ready.

Example prompts

Try these in order to test a new connection.

1. See your communities

"Which ALIS communities do I have access to?"

Tool used: alis_list_my_communities

Example answer:

You have access to 2 ALIS communities:

Oak Ridge (ID 1031), Texas, US/Central
Sunrise Gardens (ID 1024), Texas, US/Central

2. Count residents in a community

"How many residents live at Sunrise Gardens right now?"

Tool used: alis_list_residents

Example answer:

Sunrise Gardens has 84 current residents. The first few by last name are Ann Adams, Bob Baker and Carol Chen. Want the full list?

3. Find a resident's ALIS ID

"Find the ALIS ID for the resident named Baker in my communities."

Tools used: alis_list_my_communities, then alis_list_residents

Example answer:

I found one resident named Baker: Bob Baker, ALIS ID 55031, at Sunrise Gardens.

Supported tools

All tools are read-only. They only return data from your organization, limited to the communities and permissions your ALIS account has. Click a tool to see its details.

alis_list_my_communities

Lists the active ALIS communities you have access to, ordered by name. Each community includes its ID, name, time zone and US state. Use it first: other tools need a community ID from this list.

Parameters: none. The answer depends only on who you are.

Permission: every ALIS user can use it.

Example prompts

"Which ALIS communities can I see?"
"What's the community ID for Oak Ridge?"
"Which of my communities are in Texas?"

Example result

{
  "communities": [
    { "id": 1024, "name": "Sunrise Gardens", "timeZone": "US/Central", "state": "TX" },
    { "id": 1031, "name": "Oak Ridge", "timeZone": "US/Central", "state": "TX" }
  ]
}

alis_list_residents

Lists the current residents of one community, ordered by last name, with each resident's ALIS ID, first name and last name, plus the total count. Results come in pages.

Permission: needs the ALIS "View residents" permission. Only current residents are returned. No clinical, medication, assessment or billing data.

Parameters

Name	Required	Default	Rules
`communityId`	Yes	-	A community ID from `alis_list_my_communities`. Positive whole number.
`limit`	No	25	Residents per page, 1 to 100
`offset`	No	0	Residents to skip, 0 or more

Paging: when hasMore is true, the assistant calls again with offset set to nextOffset.

Example prompts

"How many residents are at Sunrise Gardens?"
"List the first 10 residents at Oak Ridge, then the next 10."
"Is there a resident named Adams at Sunrise Gardens?"

Example result

{
  "communityId": 1024,
  "communityName": "Sunrise Gardens",
  "page": {
    "items": [
      { "id": 55012, "firstName": "Ann", "lastName": "Adams" },
      { "id": 55031, "firstName": "Bob", "lastName": "Baker" }
    ],
    "totalCount": 84,
    "hasMore": true,
    "nextOffset": 25
  }
}

Disconnect or remove the connector

Disconnecting stops the AI app from reading your ALIS data. Your ALIS account and data are not changed.

Claude.ai and Claude Desktop

Turn it off for one chat: in the chat, click + → Connectors and turn off ALIS.
Disconnect your ALIS account: open Settings → Connectors, select ALIS and choose Disconnect. You can connect again later; you will sign in again.
Remove it for your organization (Team and Enterprise owners): remove ALIS from your organization's connector settings. Members can no longer connect.

Claude Code

claude mcp remove alis

Other AI apps

Remove the ALIS MCP server from your app's connector or MCP server settings.

To turn the ALIS MCP Connector off for your whole company, contact ALIS support.

Messages and what to do

On the ALIS sign-in page

Message	What to do
The company, username or password is not correct.	Check all three: use the same company, username and password you use to sign in to ALIS.
Your ALIS login is disabled. Contact your ALIS administrator.	Ask your ALIS administrator to turn your login back on.
Your ALIS password must be changed. Sign in to ALIS, change it, then try again.	Sign in to ALIS in your browser, set a new password, then connect again.
Your ALIS login uses single sign-on, which the ALIS MCP Connector does not support yet.	Not available for single sign-on logins yet. Ask your ALIS administrator about a regular ALIS login.
Your ALIS login uses two-step verification, which the ALIS MCP Connector does not support yet.	Not available for logins with two-step verification yet.
Your company limits where ALIS can be used, so the ALIS MCP Connector is not available.	Your company limits ALIS to certain networks, and the connector cannot meet that limit. Talk to your ALIS administrator.
Your ALIS role cannot use the ALIS MCP Connector.	Logins with restricted (third-party) access cannot use the connector. Ask your ALIS administrator.
Your company has not turned on the ALIS MCP Connector. Contact ALIS support.	Ask your ALIS account manager or ALIS support to turn it on for your company.
Too many sign-in attempts. Wait a minute and try again.	Wait one minute, then sign in again.

In a chat

What you see	What to do
ALIS data is temporarily unavailable. Retry in a moment.	ALIS could not answer just then. Ask again in a moment. If it keeps happening, contact ALIS support.
No community with this ID is accessible to the caller. Check the ID against alis_list_my_communities.	The community does not exist or is not one of yours. Ask "Which ALIS communities do I have access to?" and use a community from that list.
The assistant cannot list residents, or says it is not authorized.	Your ALIS role needs the "View residents" permission. Ask your ALIS administrator.
The caller has no ALIS access.	Your ALIS login has no access the connector can use. Ask your ALIS administrator.
The app asks you to connect or sign in again.	For your security, sign-in lasts up to 7 days, or 24 hours without use. Sign in again. Also expected after your ALIS password or access changes.

Security & privacy

Read-only. The connector cannot create, change or delete anything in ALIS.
Your permissions, nothing more. You sign in with your own ALIS account. The assistant only sees the communities and data that account can see in ALIS.
Your organization only. Data from other organizations is never returned.
Secure sign-in. Sign-in uses OAuth 2.0. Your ALIS password is never shared with the AI app.
Privacy policy: ALIS Privacy Policy

Support

Need help or found a problem? Contact support@go-alis.com.