Skip to main content
Glama

procare-mcp

First MCP server for the Procare Connect API — talk to your child care center data from Claude, Cursor, or any MCP client.

Procare is the leading child care management platform used by 30,000+ daycare centers, preschools, and before/after-school programs in the US. The public Connect API is documented at https://api-docs.procareconnect.com/ and powers the Procare Online + SchoolCare Works products. This server wraps that API in the Model Context Protocol so you can ask your AI agent questions like "which children at school 1234 were absent on Monday?" or "what's the balance on family 555?" — without hand-rolling a REST client.

What you can do with it

You:   "Pull the attendance log for school 1234 for last week and tell me
        which kids had 3+ absences."
Claude: *calls list_schools, then list_attendance with school_id+date_from
        +date_to, summarises the result*

You:   "Show me the enrollment roster for the summer camp at our
        Westside location."
Claude: *calls list_programs then list_registrations with school_id +
        program_id filters*

You:   "What's the outstanding balance for family 555?"
Claude: *calls get_family, returns the balance_cents field with a
        human-readable summary*

Related MCP server: mcp-db-universal

Install

pip install -e .

Configure

Procare uses OAuth 2 client_credentials against your tenant subdomain, not a shared host. Find your subdomain by looking at the URL of the Procare dashboard you log into — it'll be https://<your-subdomain>.procareconnect.com. Your Procare account admin can mint a client_id / client_secret pair with API access enabled.

export PROCARE_BASE_URL="https://<your-subdomain>.procareconnect.com"
export PROCARE_CLIENT_ID="..."
export PROCARE_CLIENT_SECRET="..."

Who uses this?

  1. Child care center owners and operators who want to query their data via Claude / Cursor without building a custom integration.

  2. Multi-location operators (5+ centers) who need to roll up attendance, payments, and enrollment across the enterprise.

  3. API Partners building tools on top of Procare.

If you don't have API credentials yet, contact your Procare account manager or open a ticket with Procare support.

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on Windows / Linux:

{
  "mcpServers": {
    "procare-mcp": {
      "command": "procare_mcp",
      "env": {
        "PROCARE_BASE_URL": "https://your-subdomain.procareconnect.com",
        "PROCARE_CLIENT_ID": "your-client-id",
        "PROCARE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Use with Claude Code

claude mcp add procare-mcp -- procare_mcp \
  --env PROCARE_BASE_URL=https://your-subdomain.procareconnect.com \
  --env PROCARE_CLIENT_ID=your-client-id \
  --env PROCARE_CLIENT_SECRET=your-client-secret

Tools

Tool

Type

What it does

health_check

Diagnostic

Verifies credentials by listing schools (counts them)

list_schools

Read

All schools/locations in the enterprise account

get_school

Read

Single school by id

list_children

Read

Children, filterable by school_id / paginated via offset+limit

get_child

Read

Single child by id (allergies, schedule, classroom)

list_families

Read

Families (households), filterable by school_id / paginated

get_family

Read

Single family by id (guardians, children, contacts, balance)

list_attendance

Read

Attendance records, filterable by school / child / date range

list_programs

Read

Programs (camps, preschool, after-school), filterable by school / active

get_program

Read

Single program by id (description, schedule, capacity, fee)

list_registrations

Read

Enrollments, filterable by program / child / school

list_payments

Read

Payments, filterable by family / school / date range

list_staff

Read

Staff members, filterable by school / active flag

get_staff_member

Read

Single staff member by id

list_classrooms

Read

Classrooms, filterable by school

get_classroom

Read

Single classroom by id (capacity, age range, lead teacher)

The read-only cut covers every endpoint exposed by the Connect API that the v0.1 surface needs. Write tools (check-in, check-out, create registration) will land in a follow-up once the upstream write contract is stable across Procare Online and SchoolCare Works.

Engineering

This server follows the industry-leading patterns baked into mcp-vertical-template:

  • Shared httpx.AsyncClient with connection pooling and transport-level retries

  • OAuth 2 client_credentials with proactive refresh (5-min buffer) and an asyncio.Lock to serialize concurrent refreshes

  • Typed exception hierarchy (ProcareAuthError, ProcareNotFoundError, ProcareRateLimitError, ProcareAPIError, ProcareConnectionError) with structured fields (http_status, error_code, request_id, retry_after)

  • Dispatch table for HTTP status → exception (no if/elif chains)

  • Application-level retry with exponential backoff + full jitter on 429/5xx, honoring Retry-After

  • Single 401 retry that force-refreshes the OAuth token (handles server-side revocation)

  • JSONL audit logging per tool call (stderr default, PROCARE_AUDIT_LOG env var override) with secret redaction

  • Bare raise inside MCP tool handlers — isError=true on the wire, per the Blackwell MCP security audit baseline

  • respx mocks + hypothesis property tests (no live API in CI)

  • ruff full rule set + mypy --strict

  • CI matrix on Python 3.10-3.13 × Ubuntu/macOS/Windows

Development

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest -v
procare_mcp

License

MIT.

See also

Available Tools

16 tools
get_childA

Fetch a single child by id (full record: allergies, schedule, etc.).

Use when: "what are the allergies for child X?" or "show me the enrollment record for this child."

Example: child_id="kid-789" returns {"id": "kid-789", "first_name": "...", "allergies": [...], "schedule": {...}, ...}.

Inputs: child_id (required). Returns: result

get_classroomA

Fetch a single classroom by id (capacity, age range, lead teacher).

Use when: "what's the capacity and age range for classroom 33?"

Inputs: classroom_id (required). Returns: result

get_familyA

Fetch a single family by id (guardians, children, contacts, balance).

Use when: "what's the balance on family 555?" or "show me the guardians

  • emergency contacts for this household."

Example: family_id="fam-555" returns {"id": "fam-555", "guardians": [...], "children": [...], "balance_cents": ...}.

Inputs: family_id (required). Returns: result

get_programA

Fetch a single program by id (description, schedule, capacity, fee).

Use when: "what's the capacity and weekly fee for program 7777?"

Inputs: program_id (required). Returns: result

get_schoolA

Fetch a single school by id (name, address, phone, hours, etc.).

Use when: "what's the address of school 1234?" or "what are the hours for our downtown location?"

Example: school_id="abc-123" returns {"id": "abc-123", "name": "..."}.

Inputs: school_id (required). Returns: result

get_staff_memberA

Fetch a single staff member by id (name, role, classrooms, schedule).

Use when: "what's the role and classroom assignment for staff 222?"

Inputs: staff_id (required). Returns: result

health_checkA

Verify credentials work. Calls list_schools (the cheapest read).

If this fails with ProcareAuthError, check PROCARE_BASE_URL (must be your tenant subdomain, e.g. https://mycenter.procareconnect.com) and that PROCARE_CLIENT_ID / PROCARE_CLIENT_SECRET are correct.

Example: call with no arguments to run a smoke test.

Inputs: no named parameters. Returns: result

list_attendanceA

List attendance records, filterable by school / child / date range.

Use when: "who was absent on Monday at school 1234?" or "give me the full attendance log for child X over the last 30 days."

Args: school_id: restrict to one school. child_id: restrict to one child. date_from: ISO date YYYY-MM-DD (inclusive). date_to: ISO date YYYY-MM-DD (inclusive). limit: max records.

Inputs: limit, date_to, child_id, date_from, +1 more. Returns: result

list_childrenA

List children enrolled, optionally filtered by school.

Use when: "show me all children at school 1234" or "list the next 50 children across all schools." Combine with offset for pagination.

Args: school_id: restrict to one school within the enterprise account. limit: max records to return (server-side cap applies). offset: skip N records for pagination.

Example: list_children(school_id="abc-123", limit=20) returns [{"id": "...", "first_name": "...", "last_name": "...", ...}, ...].

Inputs: limit, offset, school_id. Returns: result

list_classroomsA

List classrooms, optionally filtered by school.

Use when: "what classrooms do we have at school 1234?"

Inputs: school_id. Returns: result

list_familiesA

List families (households), optionally filtered by school.

Use when: "show me all families at school 1234" or "how many active households are on our books?"

Args: school_id: restrict to one school. limit: max records. offset: skip N records for pagination.

Inputs: limit, offset, school_id. Returns: result

list_paymentsA

List payments / invoices, filterable by family / school / date range.

Use when: "show me all payments for family 555 in October" or "what was our total revenue at school 1234 last month?"

Args: family_id: restrict to one family. school_id: restrict to one school. date_from: ISO date YYYY-MM-DD (inclusive). date_to: ISO date YYYY-MM-DD (inclusive). limit: max records.

Inputs: limit, date_to, date_from, family_id, +1 more. Returns: result

list_programsA

List programs (camps, preschool, after-school, summer).

Use when: "what programs do we currently offer?" or "show me the active summer programs at school 1234."

Args: school_id: restrict to one school. active: filter by active flag (True / False / None = all).

Inputs: active, school_id. Returns: result

list_registrationsA

List registrations (enrollments), filterable by program / child / school.

Use when: "who's enrolled in program 7777?" or "what programs is child X currently in?" or "how many active registrations does school 1234 have?"

Args: program_id: restrict to one program. child_id: restrict to one child. school_id: restrict to one school. limit: max records.

Inputs: limit, child_id, school_id, program_id. Returns: result

list_schoolsA

List all schools/locations accessible to the enterprise account.

Use when: "what schools are on our Procare account?" or "what center IDs do I have access to?" before calling per-school tools.

Example: returns [{"id": "...", "name": "...", ...}, ...].

Inputs: no named parameters. Returns: result

list_staffA

List staff members, optionally filtered by school / active flag.

Use when: "who are the active teachers at school 1234?" or "show me all staff across all our schools."

Inputs: active, school_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: singular get_* for individual records, plural list_* for collections, and health_check for auth verification. No two tools overlap in functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., get_child, list_schools). The only outlier is health_check, which still follows verb_noun and is standard for such tools.

    Tool Count5/5

    16 tools cover the major entities (children, classrooms, families, programs, schools, staff, attendance, payments, registrations) without being excessive. The number is well-scoped for a child care management API.

    Completeness2/5

    The tool set is entirely read-only (get and list only). No create, update, or delete operations exist for any entity, which is a significant gap for typical CRUD workflows and will cause agent failures when mutation is needed.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A database-agnostic MCP server that enables natural language queries to your database through Claude or Copilot, automatically writing and executing SQL.
      8
      5 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the FieldRoutes pest-control / lawn-care operations platform — talk to your data from Claude, Cursor, or any MCP client.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server that wraps the Housecall Pro Public API, enabling Claude to read and write Housecall Pro data (customers, jobs, estimates, invoices, etc.) via natural language.
      23
      152 npm
      MIT