list_pay_grades

Pack: usajobs · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/list_pay_grades for the schema, then POST the same URL with its arguments for the data.

Return the USAJOBS reference list of pay plan codes (GS, FW, ES, etc.) and their descriptions; use pay plan codes with the pay_grade_low/pay_grade_high search filters.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/usajobs/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_pay_grades","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('list_pay_grades', {});

Response shape

{
  "type": "object",
  "properties": {
    "CodeList": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ValidValue": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "Code": {
                  "type": "string"
                },
                "Value": {
                  "type": "string"
                },
                "LastModified": {
                  "type": "string"
                },
                "IsDisabled": {
                  "type": "string"
                }
              }
            }
          },
          "id": {
            "type": "string"
          }
        }
      }
    },
    "DateGenerated": {
      "type": "string"
    }
  },
  "description": "Pay grade/plan reference codes"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "usajobs": {
      "url": "https://gateway.pipeworx.io/usajobs/mcp"
    }
  }
}

See Getting Started for client-specific install steps.