cyberday-mcp

Cyberday MCP Server

An MCP (Model Context Protocol) server for the Cyberday.ai API. Enables AI agents (e.g. Claude Code, Claude Desktop) to read and manage your organization's data systems registry in Cyberday.

Features

| Tool | Description | |---|---| | list_systems | List data systems with pagination (default 20 per page) | | search_systems | Search/filter systems by name, status, framework, or assigned user | | get_system | Get full details of a specific system by ID | | create_system | Create a new data system | | create_system_advanced | Create or update a system with extended fields (owner, admin, cost, processors, etc.) | | systems_summary | Overview statistics: counts, status breakdown, hosting types, review status, framework coverage |

Response formatting

• Compact list view — list_systems and search_systems return only key fields (name, status, owner, hosting, etc.)
• Full details — get_system returns all fields with human-readable names (e.g. hosting_type, authentication_methods)
• Empty fields removed automatically from all responses
• HTML tags stripped from text fields
• Pagination — limit and offset parameters on list/search tools

Prerequisites

• Node.js 18+
• A Cyberday API key (requires admin access to generate)

Installation

git clone https://github.com/telepist/cyberday-mcp.git
cd cyberday-mcp
npm install
npm run build

Getting your API key

1. Log in to Cyberday
2. Go to Settings > Integration settings
3. Enable API Access
4. Copy the API key

Usage with Claude Code

Register the MCP server:

claude mcp add --transport stdio cyberday \
  -e CYBERDAY_API_KEY=your-api-key-here \
  -- node /path/to/cyberday-mcp/dist/index.js

Restart Claude Code. Then you can ask things like:

• "List our data systems"
• "Which systems are hosted outside EU?"
• "Show me the details of system 7796087"
• "Give me a summary of our system registry status"
• "Search for systems assigned to john@example.com"
• "Create a new system called 'Salesforce CRM'"

Usage with Claude Desktop

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

{
  "mcpServers": {
    "cyberday": {
      "command": "node",
      "args": ["/path/to/cyberday-mcp/dist/index.js"],
      "env": {
        "CYBERDAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Development

npm run dev    # TypeScript watch mode
npm run build  # Build for production
npm start      # Start the server

API limitations

The Cyberday public API currently supports data systems management only. Tasks, policies, frameworks, risks, and reports are not yet available via the API. The server is structured so that new endpoints can be easily added to src/index.ts as Cyberday expands its API.

Rate limit: 100 requests / 60 seconds.

License

MIT