mantis-managerManage Mantis Bug Tracker (issues, projects, users, filters, configs) via the official Mantis REST API. Supports full CRUD operations on issues, projects, users, attachments, notes, tags, relationships, and configuration management. Features dynamic instance switching with context-aware base URL and token resolution.
Install via ClawdBot CLI:
clawdbot install willykinfoussia/mantis-managerBase URL precedence (highest to lowest):
temporary_base_url — one-time use URL for specific operationsuser_base_url — user-defined URL for the current sessionMANTIS_BASE_URL — environment default URLThis allows you to:
Example:
```
// Default: uses MANTIS_BASE_URL from environment
GET {{resolved_base_url}}/issues
// Override for one operation:
temporary_base_url = "https://mantis-staging.example.com/api/rest"
GET {{resolved_base_url}}/issues
// Override for session:
user_base_url = "https://client-mantis.example.com/api/rest"
GET {{resolved_base_url}}/issues
```
Token precedence (highest to lowest):
temporary_token — one-time use token for specific operationsuser_token — user-defined token for the current sessionMANTIS_API_TOKEN — environment default tokenEnvironment variables are handled via standard OpenClaw metadata: requires.env declares required variables (MANTIS_BASE_URL, MANTIS_API_TOKEN). Any other environment variables you use for Mantis should be treated as normal process env vars and are not modeled as special OpenClaw metadata fields.
All API requests must include:
```
Authorization: Bearer {{resolved_token}}
Content-Type: application/json
```
Note: The {{resolved_base_url}} and {{resolved_token}} are determined at runtime based on the precedence rules above.
Throughout this documentation:
{{MANTIS_BASE_URL}} refers to the resolved base URL (could be temporary_base_url, user_base_url, or env MANTIS_BASE_URL){{resolved_token}} refers to the resolved token (could be temporary_token, user_token, or env MANTIS_API_TOKEN){{MANTIS_BASE_URL}}/resource/pathImportant: Always use the resolution logic to determine the actual URL and token at runtime.
Thetemporary_anduser_names here are runtime context variables used by the skill logic, not OpenClaw metadata fields. OpenClaw does not define anoptional.contextmetadata key; context is resolved dynamically at runtime as described below.
User queries:
Action:
```
Set temporary_base_url = "https://staging.mantis.com/api/rest"
Set temporary_token = "ABC123"
... perform operation ...
Clear temporary_base_url
Clear temporary_token
```
Behavior: Temporary values are automatically cleared after one use.
User queries:
Action:
```
Set user_base_url = "https://client-xyz.mantis.com/api/rest"
Set user_token = "personal_token_123"
... perform multiple operations ...
// Values persist for the entire session
```
Behavior: Session values persist until explicitly cleared or session ends.
User queries:
Action:
```
Clear user_base_url
Clear user_token
// Now uses MANTIS_BASE_URL and MANTIS_API_TOKEN from environment
```
User queries:
Response should show:
```
Current Context:
```
```
// Check production issue
Set temporary_base_url = "https://prod.mantis.com/api/rest"
Get issue 123
// Check staging issue
Set temporary_base_url = "https://staging.mantis.com/api/rest"
Get issue 123
// Compare results
```
```
// Switch to Client A
Set user_base_url = "https://clienta.mantis.com/api/rest"
Set user_token = "clienta_token"
List all projects
Get issues for project 5
// Switch to Client B
Set user_base_url = "https://clientb.mantis.com/api/rest"
Set user_token = "clientb_token"
List all projects
Get issues for project 3
```
```
// Connect to main instance as admin
Set user_token = "admin_token"
// Perform operation as specific user
Set temporary header: X-Impersonate-User = "john.doe"
Get user issues
// Back to admin
Clear temporary header
```
User queries:
Actions:
```
GET {{MANTIS_BASE_URL}}/issues
```
Query Parameters:
page_size — number of issues per page (default: 50)page — page number (1-indexed)filter_id — ID of saved filter to applyproject_id — filter by specific projectselect — comma-separated fields to return (e.g., "id,summary,status")Special endpoints:
```
GET {{MANTIS_BASE_URL}}/issues?filter_id={{filter_id}}
GET {{MANTIS_BASE_URL}}/projects/{{project_id}}/issues
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/issues/{{id}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/issues
```
Minimal body:
```json
{
"summary": "Issue summary",
"description": "Detailed description",
"category": {"name": "General"},
"project": {"id": 1}
}
```
Full body (optional fields):
```json
{
"summary": "Issue summary",
"description": "Detailed description",
"steps_to_reproduce": "1. Do this\n2. Do that",
"additional_information": "Extra info",
"category": {"id": 1, "name": "General"},
"project": {"id": 1},
"priority": {"id": 30, "name": "normal"},
"severity": {"id": 50, "name": "minor"},
"status": {"id": 10, "name": "new"},
"reproducibility": {"id": 10, "name": "always"},
"handler": {"id": 5},
"tags": [{"name": "bug"}, {"name": "ui"}],
"custom_fields": [{"field": {"id": 1}, "value": "custom value"}],
"due_date": "2026-12-31T23:59:59+00:00",
"version": {"name": "1.0"},
"target_version": {"name": "2.0"}
}
```
Create with attachments:
```
POST {{MANTIS_BASE_URL}}/issues
```
Include files array in body with base64-encoded content.
User queries:
Action:
```
PATCH {{MANTIS_BASE_URL}}/issues/{{id}}
```
Example body:
```json
{
"status": {"name": "resolved"},
"handler": {"id": 10},
"priority": {"name": "high"},
"summary": "Updated summary"
}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/issues/{{id}}
```
User queries:
Actions:
```
POST {{MANTIS_BASE_URL}}/issues/{{id}}/monitors
DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/monitors
```
Body (for specific user):
```json
{
"user": {"id": 10}
}
```
User queries:
Actions:
```
POST {{MANTIS_BASE_URL}}/issues/{{id}}/tags
PATCH {{MANTIS_BASE_URL}}/issues/{{id}}/tags
DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/tags
```
Body:
```json
{
"tags": [
{"name": "bug"},
{"name": "critical"}
]
}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/issues/{{id}}/relationships
```
Body:
```json
{
"type": {"name": "duplicate-of"},
"target_issue": {"id": 456}
}
```
Relationship types:
duplicate-ofrelated-toparent-ofchild-ofhas-duplicateUser queries:
Action:
```
POST {{MANTIS_BASE_URL}}/issues/{{id}}/files
```
Body:
```json
{
"files": [
{
"name": "screenshot.png",
"content": "base64_encoded_content_here"
}
]
}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/files/{{file_id}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/issues/{{id}}/notes
```
Body:
```json
{
"text": "Note content here",
"view_state": {"name": "public"},
"time_tracking": "PT2H30M"
}
```
With attachment:
```json
{
"text": "Note with file",
"files": [
{
"name": "log.txt",
"content": "base64_content"
}
]
}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/notes/{{note_id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/projects
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/projects/{{id}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/projects
```
Body:
```json
{
"name": "Project Name",
"description": "Project description",
"enabled": true,
"inherit_global": true,
"view_state": {"name": "public"},
"status": {"name": "development"}
}
```
User queries:
Action:
```
PATCH {{MANTIS_BASE_URL}}/projects/{{id}}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/projects/{{id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects
```
Body:
```json
{
"subproject": {"id": 10}
}
```
Action:
```
DELETE {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects/{{subproject_id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/projects/{{id}}/users
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/projects/{{id}}/users
```
Body:
```json
{
"user": {"id": 20},
"access_level": {"name": "developer"}
}
```
Access levels:
viewer (10)reporter (25)updater (40)developer (55)manager (70)administrator (90)Action:
```
DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/users/{{user_id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/projects/{{id}}/versions
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/projects/{{id}}/versions
```
Body:
```json
{
"name": "2.0",
"description": "Major release",
"released": true,
"obsolete": false,
"timestamp": "2026-06-01T00:00:00+00:00"
}
```
Action:
```
PATCH {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}}
```
Action:
```
DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/users/me
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/users/{{id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/users?name={{username}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/users
```
Minimal body:
```json
{
"username": "jane.smith",
"email": "jane@example.com",
"access_level": {"name": "reporter"}
}
```
Full body:
```json
{
"username": "jane.smith",
"password": "SecurePass123!",
"real_name": "Jane Smith",
"email": "jane@example.com",
"access_level": {"name": "developer"},
"enabled": true,
"protected": false
}
```
User queries:
Action:
```
PATCH {{MANTIS_BASE_URL}}/users/{{id}}
```
Body:
```json
{
"real_name": "Updated Name",
"email": "new@example.com",
"access_level": {"name": "developer"},
"enabled": false
}
```
User queries:
Action:
```
PUT {{MANTIS_BASE_URL}}/users/{{id}}/reset-password
```
Body:
```json
{
"password": "NewSecurePassword123!"
}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/users/{{id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/filters
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/filters/{{id}}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/filters/{{id}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/user_tokens
```
Body:
```json
{
"name": "automation_token",
"date_expiry": "2027-12-31T23:59:59+00:00"
}
```
User queries:
Action:
```
DELETE {{MANTIS_BASE_URL}}/user_tokens/{{token_id}}
```
User queries:
Action:
```
POST {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens
```
Body:
```json
{
"name": "user_token",
"date_expiry": "2027-12-31T23:59:59+00:00"
}
```
Action:
```
DELETE {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens/{{token_id}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/config/{{option}}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/config
```
Query parameters:
option — specific option nameproject_id — filter by projectuser_id — filter by userUser queries:
Action:
```
PATCH {{MANTIS_BASE_URL}}/config
```
Body:
```json
{
"configs": [
{
"option": "allow_signup",
"value": "1"
}
]
}
```
User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/lang/{{string}}
```
Query parameter:
language — language code (e.g., 'fr', 'en', 'de')User queries:
Action:
```
GET {{MANTIS_BASE_URL}}/lang
```
Query parameters:
strings — comma-separated list of string keyslanguage — language codeUser queries:
Action:
```
GET {{MANTIS_BASE_URL}}/users/me
```
Header:
```
X-Impersonate-User: {{username_or_id}}
```
Handle HTTP errors gracefully:
401 Unauthorized:
MANTIS_API_TOKEN or provide valid temporary_token403 Forbidden:
404 Not Found:
422 Unprocessable Entity:
500 Internal Server Error:
General error response format:
```json
{
"message": "Error description",
"code": 1234,
"localized": "Localized error message"
}
```
page_size and page parameters for list operationsselect parameter to return only needed fieldsselect=id,summary,status,priorityfilter_id to apply saved filtersproject_idPT2H30M (2 hours 30 minutes)2026-12-31T23:59:59+00:00```
```
```
```
```
```
```
```
When updating multiple issues:
Get all high-priority bugs:
```
```
Copy project structure:
```
```
Track user activity:
```
```
Work with multiple Mantis instances:
```
// Scenario: Compare issue status across environments
Set temporary_base_url = "https://prod.mantis.com/api/rest"
Set temporary_token = "prod_token"
GET /issues/123
Record status
Set temporary_base_url = "https://staging.mantis.com/api/rest"
Set temporary_token = "staging_token"
GET /issues/123
Record status
```
Sync data between instances:
```
// Scenario: Clone project from one instance to another
Set user_base_url = "https://source.mantis.com/api/rest"
Set user_token = "source_token"
GET /projects/5 (get project details)
GET /projects/5/versions (get versions)
GET /projects/5/users (get users)
Set user_base_url = "https://target.mantis.com/api/rest"
Set user_token = "target_token"
POST /projects (create project)
POST /projects/{{new_id}}/versions (create versions)
POST /projects/{{new_id}}/users (add users)
```
Manage multiple client instances:
```
// Scenario: Daily status report for all clients
For each client in [ClientA, ClientB, ClientC]:
1. Set user_base_url = client.mantis_url
2. Set user_token = client.api_token
3. GET /issues?filter_id=1 (get today's issues)
4. Collect statistics
5. Clear context
Generate consolidated report
```
{{MANTIS_BASE_URL}}/api/rest/swagger.yamlThis skill enables you to:
AI Usage Analysis
Analysis is being generated… refresh in a few seconds.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.