`sam_set_aside_opportunities`

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

Find federal contracts reserved for small businesses (women-owned, HUBZone, service-disabled veteran-owned, etc.). Returns titles, deadlines, and agencies.

Parameters

Name	Type	Required	Description
`set_aside`	string	yes	Set-aside type (required): SBA (Small Business), SDVOSB (Service-Disabled Veteran), HUBZone, 8AN (8(a)), WOSB (Women-Owned), EDWOSB (Economically Disadvantaged Women-Owned)
`keyword`	string	no	Optional keyword to narrow results
`naics`	string	no	Optional NAICS code filter
`limit`	number	no	Number of results to return (1-100, default 10)
`_apiKey`	string	yes	SAM.gov API key

Example call

Arguments

{
  "set_aside": "SDVOSB",
  "keyword": "construction",
  "limit": 25,
  "_apiKey": "your-samgov-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/samgov/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sam_set_aside_opportunities","arguments":{"set_aside":"SDVOSB","keyword":"construction","limit":25,"_apiKey":"your-samgov-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('sam_set_aside_opportunities', {
  "set_aside": "SDVOSB",
  "keyword": "construction",
  "limit": 25,
  "_apiKey": "your-samgov-api-key"
});

More examples

{
  "set_aside": "HUBZone",
  "_apiKey": "your-samgov-api-key"
}

Response shape

Always returns: set_aside_type, total_records, limit, opportunities

Field	Type	Description
`set_aside_type`	string	Set-aside type being searched
`total_records`	number	Total number of matching set-aside opportunities
`limit`	number	Number of results returned in this request
`opportunities`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "set_aside_type": {
      "type": "string",
      "description": "Set-aside type being searched"
    },
    "total_records": {
      "type": "number",
      "description": "Total number of matching set-aside opportunities"
    },
    "limit": {
      "type": "number",
      "description": "Number of results returned in this request"
    },
    "opportunities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opportunity title"
          },
          "solicitation_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unique solicitation identifier"
          },
          "department": {
            "type": [
              "string",
              "null"
            ],
            "description": "Procuring department/agency"
          },
          "sub_tier": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sub-tier agency code"
          },
          "office": {
            "type": [
              "string",
              "null"
            ],
            "description": "Procuring office name"
          },
          "posted_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date opportunity was posted"
          },
          "response_deadline": {
            "type": [
              "string",
              "null"
            ],
            "description": "Proposal response deadline"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Procurement type"
          },
          "set_aside": {
            "type": [
              "string",
              "null"
            ],
            "description": "Small business set-aside type"
          },
          "naics_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary NAICS code"
          },
          "classification_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Classification code"
          },
          "active": {
            "type": [
              "string",
              "null"
            ],
            "description": "Active status indicator"
          },
          "ui_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to opportunity details on SAM.gov"
          }
        }
      }
    }
  },
  "required": [
    "set_aside_type",
    "total_records",
    "limit",
    "opportunities"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

sam_set_aside_opportunities