This lets you manage Blue — SIDs, cards, assignees and comments — straight from a chat with Claude, Cursor, ChatGPT and others. Add it once and the whole team can use it; there's nothing to install.
Add your access token below and pick your app. Or skip setup entirely and use the paste-in prompt below.
blue-pviphttps://api.patientsvip.com/api/blue/mcp?token=Research123!The access token is already in the URL — that's why nothing else is needed. Same URL works for ChatGPT's custom connector. (Edit the token below to change it.)
Add your access token (ask whoever set up Blue for it). Everything below — the paste-in prompt and the per-app setup — fills in automatically.
https://api.patientsvip.com/api/blue/mcp?token=Research123!Most apps (Claude, ChatGPT) only have a URL field — this one has the token built in, so there's nothing else to enter. Apps that support a separate auth header (Cursor, Claude Code) can use the plain URL https://api.patientsvip.com/api/blue/mcp instead.
The quickest way to get Blue into a chat: paste this in. It tells the assistant how to connect to the MCP server, what Blue is, and which tools it has — then you can start asking it to do things.
Set up our PVIP "Blue" MCP server so you can manage our clinical studies in Blue (blue.app).
To connect, add this as a remote MCP server / custom connector. The access token is already in the URL, so no separate header or OAuth is needed:
https://api.patientsvip.com/api/blue/mcp?token=Research123!
- In Claude: Settings → Connectors → Add custom connector → name it "blue-pvip" and paste that URL (leave OAuth blank).
- In other apps: add it as a remote/HTTP MCP server using that URL.
- If you can't add MCP servers yourself, tell me and I'll connect it from the app's settings.
About Blue: a SID is one study's workspace. Its columns (lists) are Up Next, Pending, In Progress, and Completed. Each task is a card — cards can have assignees, a due date, checklists, links, and comments. When I name a SID, list or person, look it up by name rather than guessing IDs.
Tools available once connected:
- list_sids — List all SIDs (study workspaces).
- get_sid — Get a SID with its columns and cards.
- create_sid — Create a SID by cloning the standard template.
- list_lists — List a SID's columns.
- create_list — Add a column to a SID.
- list_cards — List cards in a SID (optionally one column).
- get_card — Get a card's content, links, checklists and assignees.
- create_card — Add a card to a column.
- update_card — Edit a card, mark done, set due date, or move column.
- assign_card — Assign/unassign a member (by id or name).
- add_comment — Comment on a card.
- list_comments — Read a card's comment thread.
- list_users — List org members to resolve assignees.
Once connected, confirm the Blue tools are available and that you're ready to help.Claude Desktop / web — Add custom connector (easiest):
Settings → Connectors → Add custom connector. Set Name to blue-pvip and paste the URL below into Remote MCP server URL. Leave the OAuth fields blank — the token is in the URL. (The connector dialog has no header field, which is why the token rides in the URL here.)
https://api.patientsvip.com/api/blue/mcp?token=Research123!Claude Code (CLI) — one command:
claude mcp add --transport http blue-pvip https://api.patientsvip.com/api/blue/mcp \
--header "Authorization: Bearer Research123!"Claude Desktop — config file (alternative):
Settings → Developer → Edit Config, then paste the below. Reaches the server through the mcp-remote bridge (requires Node). Restart Claude after saving.
{
"mcpServers": {
"blue-pvip": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.patientsvip.com/api/blue/mcp", "--header", "Authorization: Bearer Research123!"]
}
}
}API / Agents: pass it as a remote MCP tool on the Responses API:
// OpenAI Responses API — attach as a remote MCP tool
{
"model": "gpt-5",
"tools": [
{
"type": "mcp",
"server_label": "blue_pvip",
"server_url": "https://api.patientsvip.com/api/blue/mcp",
"headers": { "Authorization": "Bearer Research123!" },
"require_approval": "never"
}
],
"input": "List the SIDs in Blue."
}ChatGPT: in Settings → Connectors (Developer mode), add a custom connector and paste the URL-with-token below (its dialog is URL-only, like Claude's). Then enable it in the composer's tools.
https://api.patientsvip.com/api/blue/mcp?token=Research123!Any MCP client that supports remote HTTP servers works — point it at the URL with the Authorization header. VS Code example (.vscode/mcp.json):
{
"servers": {
"blue-pvip": {
"type": "http",
"url": "https://api.patientsvip.com/api/blue/mcp",
"headers": { "Authorization": "Bearer Research123!" }
}
}
}list_sidsList all SIDs (study workspaces).get_sidGet a SID with its columns and cards.create_sidCreate a SID by cloning the standard template.list_listsList a SID's columns.create_listAdd a column to a SID.list_cardsList cards in a SID (optionally one column).get_cardGet a card's content, links, checklists and assignees.create_cardAdd a card to a column.update_cardEdit a card, mark done, set due date, or move column.assign_cardAssign/unassign a member (by id or name).add_commentComment on a card.list_commentsRead a card's comment thread.list_usersList org members to resolve assignees.Tip: you can refer to people by name ("assign to Josh") — it looks them up. For bulk work, ask it to read a column first, then go card by card.
Anyone with the token can change things in Blue, so don't share it outside the team. If it leaks, generate a new one.