Servers Playground How we check Add a server Log in

Spruce Health MCP by usefulapi

Working · 760 ms

io.usefulapi/spruce-healthv1.15.0 Domain verified

Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only).

Communication Health & Science

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://spruce-health.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

sprucehealth_get_contact Read-only

One contact by Spruce contact id (entity_…): demographics, phones, emails, tags, custom and organization fields, integration links. GET /contacts/{contactId}.

contact_idstring, required

The contact id (e.g. "entity_0E5QDGJC03000").

Spruce Health MCP by usefulapi MCP server | mcptry

Tools (24)

sprucehealth_get_contact

One contact by Spruce contact id (entity_…): demographics, phones, emails, tags, custom and organization fields, integration links. GET /contacts/{contactId}.

read-only

Argument	Type	Description
contact_id*	string	The contact id (e.g. "entity_0E5QDGJC03000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The contact id (e.g. \"entity_0E5QDGJC03000\")."
    }
  }
}

sprucehealth_get_conversation

One conversation by id (t_…). GET /conversations/{conversationId}.

read-only

Argument	Type	Description
conversation_id*	string	The conversation id (e.g. "t_0E5QDJJC03000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "conversation_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The conversation id (e.g. \"t_0E5QDJJC03000\")."
    }
  }
}

sprucehealth_get_conversation_item

One conversation item (message, note, call, voicemail…) by id (ti_…). GET /conversationItems/{conversationItemId}.

read-only

Argument	Type	Description
conversation_item_id*	string	The conversation item id (e.g. "ti_0D4QABCC06000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "conversation_item_id"
  ],
  "properties": {
    "conversation_item_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The conversation item id (e.g. \"ti_0D4QABCC06000\")."
    }
  }
}

sprucehealth_get_member

One organization member (teammate, team or the organization) by id. GET /organization/members/{memberId}.

read-only

Argument	Type	Description
member_id*	string	The member id (e.g. "entity_0D4QABCC06000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "member_id"
  ],
  "properties": {
    "member_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The member id (e.g. \"entity_0D4QABCC06000\")."
    }
  }
}

sprucehealth_get_organization

Your Spruce organization (id and name). The id is the owner/member id used by other objects. Good first call. GET /organization.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

sprucehealth_get_phone_line

One phone line by id (pd_…). GET /phonelines/{phonelineId}.

read-only

Argument	Type	Description
phone_line_id*	string	The phone line id (e.g. "pd_26RRC7PQ6JG00").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "phone_line_id"
  ],
  "properties": {
    "phone_line_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The phone line id (e.g. \"pd_26RRC7PQ6JG00\")."
    }
  }
}

sprucehealth_get_transcription

The full transcription text and its summary (if any) for a transcription id (the transcriptionId on a call/voicemail attachment). Status pending/completed/failed/noSpeech. GET /transcriptions/{transcriptionId}.

read-only

Argument	Type	Description
transcription_id*	string	The transcription id (from a conversation item's audio attachment).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "transcription_id"
  ],
  "properties": {
    "transcription_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The transcription id (from a conversation item's audio attachment)."
    }
  }
}

sprucehealth_list_contact_conversations

The conversations (secure, SMS/phone, email, fax…) associated with one contact. GET /contacts/{contactId}/conversations.

read-only

Argument	Type	Description
contact_id*	string	The contact id (e.g. "entity_0E5QDGJC03000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The contact id (e.g. \"entity_0E5QDGJC03000\")."
    }
  }
}

sprucehealth_list_contact_fields

The organization-wide contact fields shown on every contact. Paged; totalCount included. GET /contacts/fields.

read-only

Argument	Type	Description
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_contact_integration_links

Links between a contact and external systems (Elation, Hint, athena, custom): type, external id, url. GET /contacts/{contactId}/integrationlinks.

read-only

Argument	Type	Description
contact_id*	string	The contact id (e.g. "entity_0E5QDGJC03000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The contact id (e.g. \"entity_0E5QDGJC03000\")."
    }
  }
}

sprucehealth_list_contact_tags

All contact tags of the organization. Paged with hasMore/paginationToken; totalCount included. GET /contacts/tags.

read-only

Argument	Type	Description
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_contacts

Contacts of the organization (patients, professionals, clinics): name, date of birth, phones, emails, tags, custom fields, integration links. Paged with hasMore/paginationToken; totalCount included. Use sprucehealth_search_contacts to find someone. GET /contacts.

read-only

Argument	Type	Description
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_conversation_items

The items (messages, internal notes, calls, voicemails, faxes, attachments with short-lived signed URLs) in one conversation. Order newest_first (default) or oldest_first; start_from = only items created after that time. Paged with hasMore/paginationToken; totalCount is a best-effort count. GET /conversations/{conversationId}/items.

read-only

Argument	Type	Description
order	string	Order of the items (default newest_first).
page_size	integer	Results per page (1-200). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
start_from	string	Only items created after this RFC 3339 date-time (with zone).
conversation_id*	string	The conversation id (e.g. "t_0E5QDJJC03000").
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "order": {
      "enum": [
        "newest_first",
        "oldest_first"
      ],
      "type": "string",
      "description": "Order of the items (default newest_first)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Results per page (1-200). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "start_from": {
      "type": "string",
      "description": "Only items created after this RFC 3339 date-time (with zone)."
    },
    "conversation_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The conversation id (e.g. \"t_0E5QDJJC03000\")."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_conversation_scheduled_messages

Messages scheduled to be sent later in one conversation (read only; nothing is sent or cancelled). GET /conversations/{conversationId}/scheduledmessages.

read-only

Argument	Type	Description
conversation_id*	string	The conversation id (e.g. "t_0E5QDJJC03000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "conversation_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The conversation id (e.g. \"t_0E5QDJJC03000\")."
    }
  }
}

sprucehealth_list_conversation_tags

All conversation tags of the organization. Paged; totalCount included. GET /conversations/tags.

read-only

Argument	Type	Description
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_conversations

Conversations of the organization (title, type, tags, archived, assignee, participants, last message time), ordered by creation or last message. With start_from, only conversations whose ordering time is at or after it (useful for 'what changed since…'). Eventually consistent. Paged; give start_from OR pagination_token, not both. GET /conversations.

read-only

Argument	Type	Description
order_by	string	Order by creation time or last message time (default last_message).
page_size	integer	Results per page (1-200). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
start_from	string	Only conversations whose ordering time is at or after this RFC 3339 date-time (with zone).
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "order_by": {
      "enum": [
        "created",
        "last_message"
      ],
      "type": "string",
      "description": "Order by creation time or last message time (default last_message)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Results per page (1-200). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "start_from": {
      "type": "string",
      "description": "Only conversations whose ordering time is at or after this RFC 3339 date-time (with zone)."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_internal_endpoints

The organization's own channels: Spruce phone and fax numbers, email addresses and Spruce Links, with their owner and members. GET /internalendpoints.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

sprucehealth_list_members

All members of the organization: teammates (name, email, admin, suspended), teams and the organization itself. Paged with hasMore/paginationToken; totalCount included. GET /organization/members.

read-only

Argument	Type	Description
page_size	integer	Results per page (2-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 2,
      "description": "Results per page (2-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_phone_lines

All phone lines of the organization (id, name); totalCount included. GET /phonelines.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

sprucehealth_list_read_receipts

Who has read one conversation item and when they first read it (oldest first). GET /conversationItems/{conversationItemId}/readReceipts.

read-only

Argument	Type	Description
conversation_item_id*	string	The conversation item id (e.g. "ti_0D4QABCC06000").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "conversation_item_id"
  ],
  "properties": {
    "conversation_item_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The conversation item id (e.g. \"ti_0D4QABCC06000\")."
    }
  }
}

sprucehealth_list_saved_messages

Saved message templates (private and organization-wide): title, text, internal/shared flags. Paged with hasMore/paginationToken. GET /savedmessages.

read-only

Argument	Type	Description
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_scheduled_messages

All messages scheduled to be sent from the organization (read only). Paged with hasMore/paginationToken; totalCount included. GET /scheduledmessages.

read-only

Argument	Type	Description
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_list_team_members

The members of one team (team ids come from sprucehealth_list_members, type 'team'). Paged. GET /teams/{teamId}/members.

read-only

Argument	Type	Description
team_id*	string	The team id (e.g. "entity_0D4QABCC06000").
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
pagination_token	string	The paginationToken from the previous page's reply (when hasMore is true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "team_id"
  ],
  "properties": {
    "team_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The team id (e.g. \"entity_0D4QABCC06000\")."
    },
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}

sprucehealth_search_contacts

Find contacts by free text and/or filters (category, tags, name, phone, email, invite state, created time). Filters combine with AND; values inside one filter match ANY (tags can use all/none). Paged; totalCount with totalCountRelation (eq = exact, gte = lower bound). A read: POST /contacts/search changes nothing.

read-only

Argument	Type	Description
tags	array	Contact tag text values (the `value` of a tag from sprucehealth_list_contact_tags).
free_text	string	Free-text query (name, phone, email…).
page_size	integer	Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole.
categories	array	Contact categories to include.
created_to	string	Only contacts added at or before this time (RFC 3339 with zone).
given_name	string	Given (first) name.
tags_match	string	How the tags combine: any (default), all, or none (exclude).
family_name

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      },
      "maxItems": 50,
      "description": "Contact tag text values (the `value` of a tag from sprucehealth_list_contact_tags)."
    },
    "free_text": {
      "type": "string",
      "maxLength": 500,
      "description": "Free-text query (name, phone, email…)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (1-500). Keep it small (e.g. 25-50) for long records: an oversized page is cut, but the Paging part with the cursor always stays whole."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "patient",
          "professional",
          "clinic",
          "unknown"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "description": "Contact categories to include."
    },
    "created_to": {
      "type": "string",
      "description": "Only contacts added at or before this time (RFC 3339 with zone)."
    },
    "given_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Given (first) name."
    },
    "tags_match": {
      "enum": [
        "any",
        "all",
        "none"
      ],
      "type": "string",
      "description": "How the tags combine: any (default), all, or none (exclude)."
    },
    "family_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Family (last) name."
    },
    "created_from": {
      "type": "string",
      "description": "Only contacts added at or after this time (RFC 3339 with zone)."
    },
    "invite_states": {
      "type": "array",
      "items": {
        "enum": [
          "has_account",
          "invited",
          "not_invited"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "description": "Spruce account/invite state."
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Phone numbers, e.g. 2065551234 or +12065551234."
    },
    "email_addresses": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
        "maxLength": 320
      },
      "maxItems": 20,
      "description": "Email addresses."
    },
    "pagination_token": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "The paginationToken from the previous page's reply (when hasMore is true)."
    }
  }
}