PeakMojo Server
Description
# PeakMojo Server [](https://hub.docker.com/r/peakmojo/mcp-server-peakmojo) A Python server implementation for integrating with the PeakMojo API. ## Features - Full integration with…
About
# PeakMojo Server [](https://hub.docker.com/r/peakmojo/mcp-server-peakmojo) A Python server implementation for integrating with the PeakMojo API. ## Features - Full integration with PeakMojo API endpoints - Bearer token…
Details
- Author
- peakmojo
- Downloads
- 276
- Categories
- Other
Jump to
- Full integration with PeakMojo API endpoints
- Bearer token authentication via API key
- Resource and tool-based access to PeakMojo functionality
- Automatic fallback to mock responses during development
- Comprehensive error handling with JSON error responses
- Docker support for Linux/amd64, Linux/arm64, and Linux/arm/v7
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PeakMojo ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via pip (pip install mcp-server-peakmojo) or run via Docker. Configure the required environment variable PEAKMOJO_API_KEY and optionally PEAKMOJO_BASE_URL. Can also be invoked directly from Python (python -m mcp_server_peakmojo --api-key YOUR_API_KEY) or configured in Claude Desktop as an MCP server.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"peakmojo server": {
"mcp-server-peakmojo": {
"command": "python",
"args": [
"-m",
"mcp_server_peakmojo",
"--api-key",
"YOUR_API_KEY",
"--base-url",
"YOUR_BASE_URL"
]
}
}
}
}McpServers
{
"mcp-server-peakmojo": {
"command": "python",
"args": [
"-m",
"mcp_server_peakmojo",
"--api-key",
"YOUR_API_KEY",
"--base-url",
"YOUR_BASE_URL"
]
}
}PeakMojo Server
A Python server implementation for integrating with the PeakMojo API.
Features
- Full integration with PeakMojo API endpoints
- Bearer token authentication
- Resource and tool-based access to PeakMojo functionality
- Automatic fallback to mock responses during development
Installation
pip install mcp-server-peakmojo
Configuration
The server requires the following environment variables:
- PEAKMOJO_API_KEY: Your PeakMojo API key for authentication
- PEAKMOJO_BASE_URL (optional): PeakMojo API base URL (defaults to https://api.staging.readymojo.com)
You can also configure these via command line arguments:
python -m mcp_server_peakmojo --api-key YOUR_API_KEY --base-url YOUR_BASE_URL
Available Resources
The server provides access to the following PeakMojo resources:
- Users (peakmojo://users)
- Personas (peakmojo://personas, peakmojo://personas/tags, peakmojo://personas/search)
- Scenarios (peakmojo://scenarios)
- Job Scenarios (peakmojo://job_scenarios)
- Jobs (peakmojo://jobs)
- Applications (peakmojo://applications)
- Practices (peakmojo://practices)
- Skills (peakmojo://skills)
- Certificates (peakmojo://certificates)
Available Tools
The server provides the following tools for interacting with the PeakMojo API:
User Management
-get_peakmojo_users: Get list of all users
- get_peakmojo_user: Get user details by ID
- get_peakmojo_user_stats: Get user statistics
- update_peakmojo_user_stats: Update user statistics
Persona Management
-get_peakmojo_personas: Get list of personas
- get_peakmojo_persona_tags: Get persona tags
- search_peakmojo_personas: Search for personas
- create_peakmojo_persona: Create a new persona
Scenario Management
-get_peakmojo_scenarios: Get list of scenarios
- create_peakmojo_job_scenario: Create a new job scenario
Workspace Management
-get_workspace_personas: Get personas for a workspace
Job Management
-get_job: Get job details
Application Management
-get_application: Get application details
Practice Management
-get_practice_messages: Get practice messages
Skill Management
-get_user_skills: Get user skills
Certificate Management
-get_certificates: Get list of certificates
- get_certificate_skills: Get skills for a certificate
- issue_user_certificate: Issue a certificate to a user
- add_certificate_skill_courses: Add courses to a certificate skill
Development
During development, if the API is not accessible, the server will automatically fall back to mock responses for each endpoint. This allows for development and testing without requiring a live API connection.
Error Handling
The server implements comprehensive error handling:
- Invalid API keys are logged with warnings
- Failed API requests fall back to mock responses
- HTTP errors are properly caught and logged
- All errors are returned as JSON responses with appropriate error messages
Docker Support
Prerequisites
The Docker image is built for multiple platforms:
- Linux/amd64
- Linux/arm64
- Linux/arm/v7
Option 1: Pull from Docker Hub
docker pull buryhuang/mcp-server-peakmojo:latest
Option 2: Build Locally
docker build -t mcp-server-peakmojo .
Running the Container
Basic usage with API key:
docker run \
-e PEAKMOJO_API_KEY=your_api_key_here \
-e PEAKMOJO_BASE_URL=https://api.staging.readymojo.com \
buryhuang/mcp-server-peakmojo:latest
Cross-Platform Publishing
To publish the Docker image for multiple platforms:
1. Create a new builder instance (if you haven't already):
docker buildx create --use
2. Build and push the image for multiple platforms:
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
3. Verify the image is available for the specified platforms:
docker buildx imagetools inspect peakmojo/mcp-server-peakmojo:latest
Usage with Claude Desktop
Configure the MCP server in your Claude Desktop settings:
{
"mcpServers": {
"peakmojo": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PEAKMOJO_API_KEY=your_api_key_here",
"-e",
"PEAKMOJO_BASE_URL=https://api.staging.readymojo.com",
"peakmojo/mcp-server-peakmojo:latest"
]
}
}
}
Example running from source
If you want to run directly from the source code:
{
"mcpServers": {
"peakmojo": {
"command": "python",
"args": [
"-m",
"mcp_server_peakmojo",
"--api-key",
"your_api_key_here",
"--base-url",
"https://api.staging.readymojo.com"
]
}
}
}
Contributing
1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
