# Servicialo MCP Server

Gives an AI agent access to the Servicialo protocol: find a provider, book a session, confirm it, settle payment. Useful when the agent has to run real appointments, not just write code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: servicialo
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/servicialo/mcp-server/tree/HEAD/packages/mcp-server
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/servicialo-mcp-server

## What it does

Servicialo is an open protocol for human-delivered services: healthcare, legal work, tutoring, home visits. The `@servicialo/mcp-server` package exposes it as 40 MCP tools, grouped by the phases of a service lifecycle. The agent follows the natural order of coordinating a booking instead of calling endpoints per database entity: locate the organization, check the slot, book, confirm, carry it through to payment.

Three phases need no auth. `resolve.lookup` maps an org slug to its MCP/REST endpoint, `registry.search` filters by country and vertical, and `scheduling.check_availability` checks three variables at once — provider, client and resource. Beyond that you need scopes such as `service:read`, `schedule:write` or `patient:write`; each tool group lists its own.

This is a protocol-level interface, not a connector to one vendor. Coordinalo is the reference implementation and the default target, but a compatible backend of your own can take its place. The protocol sits at v0.10 (draft) and releases stay on `0.9.x`, so breaking changes are still on the table — before 1.0 they go through an RFC. If your backend does not implement a given scope, that phase of the lifecycle will not work.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -- npx -y @servicialo/mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server -- npx -y @servicialo/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@servicialo/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@servicialo/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server npx -y @servicialo/mcp-server
```

## When to use it
- book a client into a session through the agent
- check whether a provider is free at a given time
- move a service from request to confirmation and payment
- find an organization by country and vertical in a shared registry
- pull a trust score for an organization before booking

## Example prompts
- Search the registry for kinesiology providers in Spain and list what they offer
- Check this provider's availability next week and book a session
- Show the current state of the service and move it to confirmed

## Similar
- [opentrons-integration](https://affpapa.org/en/nevibecode/skills/opentrons-integration.md) — skill · 1900 installs
- [mcp](https://affpapa.org/en/nevibecode/mcp/seldonframe-mcp.md) — MCP server · ★ 67
- [Tripyana London Chauffeur](https://affpapa.org/en/nevibecode/mcp/tripyana-london-chauffeur.md) — MCP server
- [flightclaw](https://affpapa.org/en/nevibecode/skills/flightclaw.md) — skill · 1100 installs
- [mcp-protocol-specialist](https://affpapa.org/en/nevibecode/agents/mcp-protocol-specialist.md) — subagent · 781 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md