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.

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

mcp-availability-server