Skip to main content
Glama
mcp-availability-server

mcp-availability-server

by JulianThorpe

mcp-availability-server

A small Model Context Protocol (MCP) server written in TypeScript. It exposes two tools that an MCP-capable client (such as Claude Desktop or Claude Code) can discover and call:

  • check_availability — returns available appointment slots for a given date.

  • format_call_summary — turns a caller, intent and next action into a tidy SMS-style summary.

The server communicates over stdio, the transport MCP clients use to launch and talk to a local server process. The tool logic is self-contained so the server runs anywhere with no API keys or external services.

Why this exists

I build production AI systems that use tool-calling and orchestration (a conversational agent on the Anthropic API, and a phone voice agent on Telnyx). This repo is a clean, minimal example of authoring an MCP server: defining tools with typed input schemas, returning structured content, and serving them over the MCP stdio transport.

Related MCP server: clinic-engine

Requirements

  • Node.js 18 or later

Install and build

npm install
npm run build

Run

npm start
# or
node build/index.js

The server runs on stdio and logs availability-server: MCP server running on stdio to stderr.

Use it with Claude Desktop

Add this to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "availability": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-availability-server/build/index.js"]
    }
  }
}

Restart Claude Desktop, and the two tools will be available in conversation.

Tools

check_availability

Input

Type

Description

date

string (YYYY-MM-DD)

The date to check. Weekends return no slots.

format_call_summary

Input

Type

Description

caller

string

Caller name or number

intent

string

What the caller wanted

next_action

string

The agreed next step

License

MIT

Available Tools

2 tools
check_availabilityCheck availabilityB

Return available appointment slots for a given date (YYYY-MM-DD). Weekends return no slots.

Inputs: date (required).

format_call_summaryFormat call summaryA

Format a concise SMS-style summary of an inbound call from caller, intent and next action.

Inputs: caller (required), intent (required), next_action (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools serve entirely different purposes—one for checking appointment availability and one for formatting call summaries—so there is no ambiguity between them.

    Naming Consistency5/5

    Both tools use a clear verb_noun pattern with underscores (check_availability and format_call_summary), maintaining consistency.

    Tool Count2/5

    With only two tools covering disparate domains (availability and call summaries), the tool count is too low for coherent scope; each domain would benefit from additional related tools.

    Completeness2/5

    The tool surface is severely incomplete for both implied domains: for availability, CRUD operations are missing; for call summaries, creation and editing are absent, leaving significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides MCP tools to list valid appointment slots, schedule, reschedule, and cancel appointments under a clinic's business policy (hours, buffers, minimum notice, practitioner availability).
      1
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables access to patient records, symptom triage, appointment scheduling, and hospital data lookup through a JSON-RPC MCP interface with HTTP and stdio transports.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only, deterministic tools for searching accounts and knowledge and retrieving tickets, ticket details, and product information over a stdio MCP connection.
      MIT