MCP server

The Sadakio MCP server connects your AI assistant straight to your data. Nothing to install, the command fetches the package itself, the server only reads and changes nothing.

Install

npx sadakio-mcp    # Node 18 and up
uvx sadakio-mcp    # Python 3.10 and up

Paste into your client's config file and add your sk_ key:

{
  "mcpServers": {
    "sadakio": {
      "command": "npx",
      "args": ["-y", "sadakio-mcp"],
      "env": { "SADAKIO_API_KEY": "sk_YOUR_KEY" }
    }
  }
}

The same block works in Claude Desktop, Claude Code, Cursor and every MCP-speaking client.

Tools

Tool	What it does
`list_guests`	Guest list: search and pagination, phones masked (KVKK)
`get_guest`	One guest: with their cards and program type
`list_visits`	Visit feed: with date filters
`get_retention`	Returning-guest summary: 7, 30 and 365-day windows

What to ask

Ask your assistant in plain language:

«How many guests came back this month, compare with last month»
«List guests with more than 5 visits who have not come in 60 days»
«How many stamps were recorded yesterday»

Packages: npm · PyPI · MIT license

This page as .md: /en/docs/mcp.md