`search`

Pack: usajobs · Endpoint: https://gateway.pipeworx.io/usajobs/mcp

Search USAJOBS announcements. Returns title, agency, location, salary band, posting/closing dates.

Parameters

Name	Type	Required	Description
`keyword`	string	no	Free-text — title + description + agency name
`location`	string	no	City/state (e.g. “San Francisco, CA”)
`position_title`	string	no	Restrict to job title field
`organization`	string	no	Agency code or name (e.g. “VATA” or “Veterans”)
`pay_grade_low`	string	no	”GS5”, “GS9”, “SES”, …
`pay_grade_high`	string	no
`remote`	boolean	no	Telework/remote only
`results_per_page`	number	no	1-500 (default 25)
`page`	number	no	1-based page

Example call

Arguments

{
  "keyword": "software engineer",
  "location": "Washington, DC",
  "results_per_page": 25
}

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":"search","arguments":{"keyword":"software engineer","location":"Washington, DC","results_per_page":25}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search', {
  "keyword": "software engineer",
  "location": "Washington, DC",
  "results_per_page": 25
});

More examples

{
  "position_title": "Data Analyst",
  "organization": "VATA",
  "pay_grade_low": "GS9",
  "pay_grade_high": "GS12",
  "remote": true
}

Response shape

Field	Type	Description
`SearchResult`	object	Search result metadata and job postings
`JobData`	array	Array of job posting objects

Full JSON Schema

{
  "type": "object",
  "description": "Search results from USAJOBS API",
  "properties": {
    "SearchResult": {
      "type": "object",
      "description": "Search result metadata and job postings",
      "properties": {
        "SearchResultCount": {
          "type": "integer",
          "description": "Total number of matching results"
        },
        "SearchResultCountAll": {
          "type": "integer",
          "description": "Total count across all pages"
        },
        "PageNumber": {
          "type": "integer",
          "description": "Current page number"
        },
        "UserArea": {
          "type": "object",
          "description": "User-specific search result details"
        }
      }
    },
    "JobData": {
      "type": "array",
      "description": "Array of job posting objects",
      "items": {
        "type": "object",
        "description": "Individual job posting",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique job posting ID"
          },
          "MatchedObjectDescriptor": {
            "type": "object",
            "description": "Job posting details",
            "properties": {
              "AnnouncementNumber": {
                "type": "string",
                "description": "USAJOBS announcement number"
              },
              "PositionTitle": {
                "type": "string",
                "description": "Job title"
              },
              "OrganizationName": {
                "type": "string",
                "description": "Federal agency name"
              },
              "LocationName": {
                "type": "array",
                "description": "Work locations",
                "items": {
                  "type": "string"
                }
              },
              "PublicationStartDate": {
                "type": "string",
                "description": "ISO date when posting opened"
              },
              "ApplicationCloseDate": {
                "type": "string",
                "description": "ISO date when applications close"
              },
              "SalaryRangeFrom": {
                "type": "number",
                "description": "Minimum annual salary"
              },
              "SalaryRangeTo": {
                "type": "number",
                "description": "Maximum annual salary"
              },
              "SalaryBasis": {
                "type": "string",
                "description": "Salary basis code (e.g. PA for per annum)"
              },
              "JobGrade": {
                "type": "array",
                "description": "Pay grade codes",
                "items": {
                  "type": "object",
                  "properties": {
                    "Code": {
                      "type": "string",
                      "description": "Pay grade code"
                    }
                  }
                }
              },
              "PositionScheduleTypeCode": {
                "type": "string",
                "description": "Work schedule type"
              },
              "TeleworkIndicator": {
                "type": "boolean",
                "description": "Whether telework is available"
              }
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

search