Server definition

Hash: sha256:1940dd2249532ca3d1350bf9697ca17b6c08b451b518c72a22a602c7bce375b9
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "Opsera DevOps AI Agent — provides tools for managing CI/CD pipelines, tasks, tools, insights, users, groups, and more via the Opsera platform API. Use the 'operation' parameter on each tool to select the desired action. See the docs:api-reference resource for full API details.",
  "tools": [
    {
      "description": "Group management: list, get, create, delete, get_memberships, add/remove/patch members. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "description": "Request body: for create (group object), add_members/remove_members (array of user IDs), patch_members (patch payload)."
          },
          "groupName": {
            "description": "Required for get, delete, get_memberships, add_members, remove_members, patch_members. Path parameter.",
            "type": "string"
          },
          "id": {
            "description": "Query param for list (comma-separated group IDs).",
            "type": "string"
          },
          "operation": {
            "description": "One of: list, get, create, delete, get_memberships, add_members, remove_members, patch_members",
            "type": "string"
          },
          "search": {
            "description": "Query param for list.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_groups",
      "outputSchema": null
    },
    {
      "description": "Insights: dashboards, filters, audit logs, KPIs, tool mappings. See docs/API_REFERENCE.md for all operations.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for create/update/post operations.",
            "type": "object"
          },
          "categories": {
            "description": "Query: dashboards_list.",
            "type": "string"
          },
          "category": {
            "description": "Query: kpis_list.",
            "type": "string"
          },
          "dashboardId": {
            "description": "Path param: audit_by_dashboard, audit_dashboard_stats, audit_dashboard_view.",
            "type": "string"
          },
          "filterId": {
            "description": "Path param: filters_get, filters_update, filters_delete.",
            "type": "string"
          },
          "groupId": {
            "description": "Path param: filters_get.",
            "type": "string"
          },
          "id": {
            "description": "Path param: dashboards get/update/delete, filters update/delete, audit_by_id.",
            "type": "string"
          },
          "limit": {
            "description": "Query: dashboards_list.",
            "type": "string"
          },
          "mappingId": {
            "description": "Path param: audit_by_mapping.",
            "type": "string"
          },
          "operation": {
            "description": "e.g. dashboards_list, dashboards_get, filters_create, audit_most_viewed, kpis_list, tool_mappings_supported, ...",
            "type": "string"
          },
          "operationId": {
            "description": "Path param: tool_mappings_operation_status.",
            "type": "string"
          },
          "search": {
            "description": "Query: dashboards_list.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_insights",
      "outputSchema": null
    },
    {
      "description": "Data mappings: list, get, create, update. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for create/update.",
            "type": "object"
          },
          "id": {
            "description": "Required for get/update. Path parameter (mapping ID).",
            "type": "string"
          },
          "operation": {
            "description": "One of: list, get, create, update",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_mappings",
      "outputSchema": null
    },
    {
      "description": "Pipeline parameters: reusable, configurable key-value pairs scoped to a pipeline. Parameters can be referenced by pipeline steps during execution for dynamic configuration (environment variables, secrets, build flags, deployment targets). Use list to see all parameters for a pipeline before triggering a run. Use create/update to set runtime values. Use get_value for lightweight value retrieval. Parameter types: string (default), number, boolean, secret (masked in logs). See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for create/update. Fields: name (string, required), value (string/number/boolean/object), type (string|number|boolean|secret, default string), description (optional).",
            "type": "object"
          },
          "operation": {
            "description": "One of: list, get, create, update, delete, get_value. list: all parameters for a pipeline. get: single parameter by ID. create: new parameter. update: modify existing. delete: remove parameter. get_value: retrieve only the parameter value.",
            "type": "string"
          },
          "parameterId": {
            "description": "Required for get, update, delete, get_value. The parameter ID (24-char MongoDB ObjectId).",
            "type": "string"
          },
          "pipelineId": {
            "description": "Required for list and create. The pipeline ID (24-char MongoDB ObjectId).",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_pipeline_parameters",
      "outputSchema": null
    },
    {
      "description": "Pipelines: monitor runs, security audit, run duration stats, configuration, templates, and lifecycle actions. Execution questions (image tag, artifact, commit SHA): list_runs then get_run (view=artifacts by default). Do not call get afterward. security_audit: find pipelines with disabled security steps; set includeStats=true to include each pipeline average/min/max run duration. runs_stats: average/min/max run duration for one pipelineId or batch pipelineIds (no security filter). get with view=security audits one known pipeline; get without view is full config (large). list is a lightweight catalog. list_runs is recent run timing. action runs mutations. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "For operation action: run, stop, reset, delete, update, status, approve, reject, create.",
            "type": "string"
          },
          "body": {
            "additionalProperties": true,
            "description": "Request body for validate, step_metadata, and other POST operations.",
            "type": "object"
          },
          "branch": {
            "description": "For action=run: branch name to override at runtime. Without repository: sets settings.branch (workflow source branch). With repository: auto-builds settings.stepParameters for that repo (per-step override).",
            "type": "string"
          },
          "disabledOnly": {
            "description": "For security_audit. When true (API default), only pipelines with at least one disabled security step.",
            "type": [
              "null",
              "boolean"
            ]
          },
          "includeLogs": {
            "description": "For get_run only. When true, request view=full with console logs. Ignored when view is set. Default uses view=artifacts.",
            "type": [
              "null",
              "boolean"
            ]
          },
          "includeStats": {
            "description": "For security_audit. When true, attach runStats (average/min/max duration) per returned pipeline. Use for average execution time where security steps are disabled.",
            "type": [
              "null",
              "boolean"
            ]
          },
          "limit": {
            "description": "list_runs: recent runs (5-10, default 5). runs_stats and security_audit includeStats: recent runs to average (5-100, default 30).",
            "type": "string"
          },
          "operation": {
            "description": "One of list, get, list_runs, get_run, security_audit, runs_stats, validate, step_metadata, pipeline_run_notification, settings_demo, settings_source, templates_list, templates_get, action. list: catalog. get: full stage config (large; design/edit; view=security for one-pipeline security step audit). list_runs: recent run timing. get_run: artifacts/image tags/commitSha (do not also call get for execution questions). security_audit: pipelines with disabled security steps; set includeStats=true to attach each pipeline avg/min/max duration. runs_stats: avg/min/max duration for one pipelineId or batch pipelineIds (no security filter). action: run, stop, create, update.",
            "type": "string"
          },
          "page": {
            "description": "Query: list, templates_list, or security_audit page number (default 1).",
            "type": "string"
          },
          "pageSize": {
            "description": "Query for list or security_audit scan: items per page (default 50, max 200).",
            "type": "string"
          },
          "payload": {
            "additionalProperties": true,
            "description": "For operation action: (reject) reason; (run) additional execution payload passed to the orchestrator.",
            "type": "object"
          },
          "pipelineId": {
            "description": "Required for get, list_runs, get_run; also for runs_stats when querying a single pipeline. MongoDB ObjectId.",
            "type": "string"
          },
          "pipelineIds": {
            "description": "Comma-separated MongoDB ObjectIds for security_audit or runs_stats batch (max 50). For runs_stats use pipelineId or pipelineIds.",
            "type": "string"
          },
          "repository": {
            "description": "For action=run: step repository path (e.g. OpseraEngineering/opsera-mcp) for per-step branch override. Used with branch to auto-build settings.stepParameters. Not needed when overriding the workflow source branch (use branch alone).",
            "type": "string"
          },
          "runCount": {
            "description": "Required for get_run. Run number from list_runs (e.g. latest runCount).",
            "type": "string"
          },
          "search": {
            "description": "Query: list or templates_list keyword filter on name and description.",
            "type": "string"
          },
          "settings": {
            "additionalProperties": true,
            "description": "For operation action: (create/update) workflow with source and plan; (run) dynamic runtime overrides. Two branch mechanisms: (1) settings.branch overrides the workflow source branch, (2) settings.stepParameters overrides branches for non-source repos per step: {\"stepParameters\":{\"Org/Repo\":{\"branch\":\"...\"}}}. Convenience: set branch alone for workflow source override; set repository + branch to auto-build stepParameters for a step repo. Both can coexist. Other runtime options: serviceNowToolId, repositoryTag, scriptType, steps, jobNames. NOTE: pipeline parameters are NOT overridden via settings — update them first with opsera_pipeline_parameters, then trigger the run. See docs/API_REFERENCE.md.",
            "type": "object"
          },
          "size": {
            "description": "Query: templates_list items per page (default 25).",
            "type": "string"
          },
          "sort": {
            "description": "Query: templates_list. One of: newest, oldest, name, lastupdated.",
            "type": "string"
          },
          "status": {
            "description": "Query: list filters by last run status; templates_list filters active or inactive.",
            "type": "string"
          },
          "target": {
            "description": "For operation action: pipeline ID (single) or comma-separated IDs for batch.",
            "type": "string"
          },
          "templateId": {
            "description": "For operation=templates_get: pipeline template ID (24-char alphanumeric).",
            "type": "string"
          },
          "type": {
            "description": "Query: templates_list template type filter.",
            "type": "string"
          },
          "view": {
            "description": "For get: full (default), summary, or security. For get_run: full, summary, artifacts (default), or logs.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_pipelines",
      "outputSchema": null
    },
    {
      "description": "Projects: list, get, create, update. See docs/API_REFERENCE.md for operations.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for create/update.",
            "type": "object"
          },
          "operation": {
            "description": "One of: list, get, create, update",
            "type": "string"
          },
          "projectId": {
            "description": "Required for get/update. Path parameter.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_projects",
      "outputSchema": null
    },
    {
      "description": "Reports and logs: reports_tasks_created, reports_pipelines_created, logs_audit_user, logs_task. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "body": {
            "additionalProperties": true,
            "description": "Request body for logs_task.",
            "type": "object"
          },
          "end_date": {
            "description": "Query: reports.",
            "type": "string"
          },
          "end_time": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "group_by": {
            "description": "Query: reports.",
            "type": "string"
          },
          "include_data": {
            "description": "Query: reports.",
            "type": "string"
          },
          "operation": {
            "description": "One of: reports_tasks_created, reports_pipelines_created, logs_audit_user, logs_task",
            "type": "string"
          },
          "page": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "page_size": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "period": {
            "description": "Query: reports.",
            "type": "string"
          },
          "secondary_action": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "start_date": {
            "description": "Query: reports.",
            "type": "string"
          },
          "start_time": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "target_id": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "type": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "user_email": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          },
          "user_id": {
            "description": "Query: logs_audit_user.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_reports_and_logs",
      "outputSchema": null
    },
    {
      "description": "Cross-entity discovery and platform settings. search finds pipeline, task, or registry records by name or ID and returns lightweight metadata only — not execution history, artifacts, durations, or full stage configuration (use opsera_pipelines for those). org_hierarchy and settings_tasks for organizational mapping and task configuration updates. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for org_hierarchy and settings_tasks.",
            "type": "object"
          },
          "c": {
            "description": "search: category filter (pipeline type, task category, or tool identifier).",
            "type": "string"
          },
          "count": {
            "description": "search: max results (default 100).",
            "type": [
              "null",
              "number"
            ]
          },
          "field": {
            "description": "search: limit match to name, description, tags, or owner.",
            "type": "string"
          },
          "m": {
            "description": "search: exact-match field, e.g. _id for lookup by MongoDB ObjectId.",
            "type": "string"
          },
          "operation": {
            "description": "One of search, org_hierarchy, settings_tasks. search: cross-entity discovery by name or ID. org_hierarchy: org and project mapping. settings_tasks: bulk task settings updates.",
            "type": "string"
          },
          "regex": {
            "description": "search: enable regex matching.",
            "type": [
              "null",
              "boolean"
            ]
          },
          "s": {
            "description": "search: query string (name, description, or ID fragment). Omit with t set to list all accessible entities of that type.",
            "type": "string"
          },
          "t": {
            "description": "search: required entity type — pipeline, task, or registry. Returns lightweight metadata only (id, name, tags, owner); not run history, artifacts, or full configuration.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_search_data_settings",
      "outputSchema": null
    },
    {
      "description": "Tasks: list, create, status, lookup; lifecycle mutations via operation=action (run, stop, create, update, status). See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "For operation=action: status, create, update, run, stop.",
            "type": "string"
          },
          "body": {
            "additionalProperties": true,
            "description": "Request body for other operations; or for action use action/target/settings/payload.",
            "type": "object"
          },
          "operation": {
            "description": "One of: list, create, create_batch, task_status, tasks_lookup, tasks_status, action",
            "type": "string"
          },
          "payload": {
            "additionalProperties": true,
            "description": "For operation=action: optional extra payload.",
            "type": "object"
          },
          "settings": {
            "additionalProperties": true,
            "description": "For operation=action with action=update: task settings.",
            "type": "object"
          },
          "target": {
            "description": "For operation=action: task ID or comma-separated IDs (optional for create).",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_tasks",
      "outputSchema": null
    },
    {
      "description": "Tools & registry: identifiers, registry, scm_repositories, scm_branches, registry_configurations. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "additionalProperties": true,
            "description": "Request body for scm_repositories, scm_branches, registry_configurations.",
            "type": "object"
          },
          "enabledInToolRegistry": {
            "description": "Query: identifiers.",
            "type": [
              "null",
              "boolean"
            ]
          },
          "fields": {
            "description": "Query: identifiers, registry.",
            "items": {
              "type": "string"
            },
            "type": [
              "null",
              "array"
            ]
          },
          "operation": {
            "description": "One of: identifiers, registry, scm_repositories, scm_branches, registry_configurations",
            "type": "string"
          },
          "search": {
            "description": "Query: identifiers, registry.",
            "type": "string"
          },
          "status": {
            "description": "Query: identifiers.",
            "type": "string"
          },
          "tool_identifier": {
            "description": "Query: registry.",
            "type": "string"
          },
          "type": {
            "description": "Query: identifiers.",
            "type": "string"
          },
          "usage": {
            "description": "Query: identifiers.",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_tools",
      "outputSchema": null
    },
    {
      "description": "User management: get_current, get, list (optional active=true|false), create, delete. See docs/API_REFERENCE.md.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "description": "Optional for list. true or false. Omit to default to active users (true). Use false for deactivated users.",
            "type": "string"
          },
          "body": {
            "additionalProperties": true,
            "description": "Request body for create.",
            "type": "object"
          },
          "id": {
            "description": "Query param for list (comma-separated user IDs).",
            "type": "string"
          },
          "operation": {
            "description": "One of: get_current, get, list, create, delete.",
            "type": "string"
          },
          "search": {
            "description": "Query param for get_current and list (e.g. [email protected]).",
            "type": "string"
          },
          "userId": {
            "description": "Required for get/delete. Path parameter (MongoDB ObjectId or email).",
            "type": "string"
          }
        },
        "required": [
          "operation"
        ],
        "type": "object"
      },
      "name": "opsera_users",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:1940dd2249532ca3d1350bf9697ca17b6c08b451b518c72a22a602c7bce375b9 | sha256sum