Maximo

You run a focused MCP server that bridges the IBM Maximo API to your MCP client. It lets you perform Maximo resource operations, such as retrieving asset details or listing assets, through a standardized MCP interface and a simple local Python server.

How to use

You will run the local MCP server and connect your MCP client to it. Start the server in one terminal, then use your MCP client to invoke the available tools. The server handles requests by calling the corresponding tool functions, which in turn query the Maximo API and return the results to you.

Key workflow patterns:

• Retrieve asset details by ID using the maximo_mcp tool set
• List assets with optional filtering and pagination
• Provide your Maximo API endpoint and credentials through environment variables to authorize requests

How to install

pip install -r requirements.txt

# Create environment file with your credentials
# Replace placeholders with your actual values
cat > .env << 'ENV'
MAXIMO_API_URL=https://your-maximo-instance.com
MAXIMO_API_KEY=your-maximo-api-key
GOOGLE_API_KEY=your-google-api-key
ENV

Additional setup and running

python mcp_server.py

The server will start and listen on http://localhost:5001. Leave this terminal open while you interact with the MCP client from another session.

# In a separate terminal, you can test the available endpoints via your MCP client
# or set up the client to target http://localhost:5001

Available tools

get_asset

Fetches details for a specific asset by its ID, returning properties such as status, location, and configuration.

list_assets

Retrieves a paginated list of assets with optional filtering using an oslc.where clause to limit results by criteria such as status.