sadmin2025-mcp-server

buslogic/sadmin2025-mcp-server

3.1

If you are the rightful owner of sadmin2025-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The SADMIN 2025 MCP Server is designed for seamless integration with the SADMIN 2025 API, providing a robust framework for task and epic management, along with additional features like comments and file attachments.

SADMIN 2025 MCP Server

MCP (Model Context Protocol) server for native SADMIN 2025 API integration with Claude Code.

Features

  • šŸ”§ Type-safe API integration
  • šŸ“‹ Task management (CRUD operations)
  • šŸ“Š Epic management
  • šŸ’¬ Comments system
  • šŸ“Ž File attachments
  • šŸ” Smart search and filtering
  • āš” Auto-completion support
  • šŸ›”ļø Built-in error handling

Installation

npm install @buslogic/sadmin2025-mcp

Configuration

  1. Copy .env.example to .env:
cp .env.example .env
  1. Configure your SADMIN API credentials:
SADMIN_API_URL=https://sadmin2025api.ticketing.rs/api/claude
SADMIN_API_KEY=your_api_key_here
SADMIN_PROJECT_ID=your_project_id_here

Usage

As MCP Server

# Development
npm run dev

# Production
npm run build
npm start

In Claude Code

Once the MCP server is running, Claude Code will automatically detect and use the available functions:

  • sadmin_getTasks - Get list of tasks
  • sadmin_getTask - Get task details
  • sadmin_createTask - Create new task
  • sadmin_updateTaskStatus - Update task status
  • sadmin_getEpics - Get list of epics
  • sadmin_createEpic - Create new epic
  • sadmin_getComments - Get comments for a task
  • sadmin_addComment - Add comment to task
  • sadmin_getAttachments - Get attachments for an entity
  • sadmin_uploadAttachment - Upload file attachment
  • sadmin_downloadAttachment - Download attachment by ID

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Run test coverage
npm run test:coverage

# Build for production
npm run build

# Test the server
./scripts/test-server.sh

Project Structure

sadmin2025-mcp-server/
ā”œā”€ā”€ src/
ā”‚   ā”œā”€ā”€ index.ts          # Express server and MCP endpoints
ā”‚   ā”œā”€ā”€ client.ts         # SADMIN API client
ā”‚   ā”œā”€ā”€ config.ts         # Configuration management
ā”‚   ā”œā”€ā”€ types/            # TypeScript type definitions
ā”‚   ā””ā”€ā”€ utils/            # Utility functions
ā”‚       ā””ā”€ā”€ validation.ts # Zod validation schemas
ā”œā”€ā”€ tests/                # Unit tests
ā”œā”€ā”€ examples/             # Usage examples
ā”œā”€ā”€ docs/                 # Documentation
ā”‚   ā””ā”€ā”€ API.md           # API reference
ā””ā”€ā”€ scripts/              # Utility scripts
    ā””ā”€ā”€ test-server.sh   # Server testing script

API Functions

Task Management

sadmin_getTasks(options?)

Get list of tasks with optional filters.

const tasks = await sadmin_getTasks({
  projectId: "project-id",
  status: "TODO",
  type: "TASK"
});
sadmin_createTask(data)

Create a new task.

const task = await sadmin_createTask({
  projectId: "project-id",
  title: "New task",
  description: "Task description",
  type: "TASK",
  priority: "HIGH"
});

Epic Management

sadmin_getEpics(options?)

Get list of epics with optional filters.

const epics = await sadmin_getEpics({
  projectId: "project-id",
  status: "IN_PROGRESS"
});

License

MIT

Author

buslogic

Links