The Admina MCP Server provides comprehensive IT asset and identity management through the Admina API, enabling management of devices, identities, and SaaS accounts.
Organization Management: Retrieve organization details including name, status, and system language.
Device Management: List devices with advanced filtering (type, subtype, status, custom fields, date ranges, assigned people) and text search; create devices with asset number, model, and subtype; update device information and specifications; manage device assignments to people, status, and location; track device lifecycle from procurement to decommission.
Custom Field Management: Retrieve, create, update, and delete custom field definitions for devices supporting text, number, date, and dropdown types.
Identity Management: List organizational identities with filtering by status (active, retired, on leave), department, and type; search by email or name.
Service & Account Management: List integrated SaaS services with account previews; retrieve accounts for specific services with filtering by roles, 2FA status, licenses, activity, and alerts; get all SaaS accounts belonging to a specific person.
Key Features: Cursor-based pagination for large datasets, advanced filtering and sorting, multi-service account visibility.
Configuration: Requires organization ID and API key for authentication.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Admina MCP Servershow me all devices in our organization"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
admina-mcp-server
MCP server for the Admina API.
Tools and API Documentation
get_devices: Return a list of devices. Get Devices API
get_identities: Return a list of identities. Get Identities API
get_services: Return a list of services integrations that belongs to organization along with a preview of accounts. Organization Services API
get_service_accounts: Return a list of accounts for a specific service. Get Service Accounts API
get_people_accounts: Return a list of all SaaS accounts belonging to a person. Get People Accounts API
Configuration
To configure the admina-mcp-server, you will need the organizationId and an API key. For more details on obtaining your API key, please refer to the Getting Started Guide.
MCP Client Configuration
To configure this MCP server, add the following configuration to your mcp settings.
For local set up, run yarn build:dev and set the path to the root dir.
Releasing
Preparing a release
Bump up a package version of
package.json. A Git commit will be created automatically.
Push the change to the main branch as usual.
Creating a release
Create a new release in GitHub by clicking on "Releases" and then "Draft a new release"
Set the Tag version to a new tag
Set the Target as main.
Set the Release title to the tag you created, vX.Y.Z
Click "Publish release" to save and publish your release.
GitHub Actions workflow will be triggerd by publishing a new release and the package will be released.