`sam_get_opportunity`

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

Get full details for a federal contract opportunity by solicitation number. Returns description, contact info, deadlines, attachments, NAICS codes, and set-aside status.

Parameters

Name	Type	Required	Description
`solicitation_number`	string	yes	The solicitation number to look up (e.g., “W912DY-24-R-0001”)
`_apiKey`	string	yes	SAM.gov API key

Example call

Arguments

{
  "solicitation_number": "W912DY-24-R-0001",
  "_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_get_opportunity","arguments":{"solicitation_number":"W912DY-24-R-0001","_apiKey":"your-samgov-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('sam_get_opportunity', {
  "solicitation_number": "W912DY-24-R-0001",
  "_apiKey": "your-samgov-api-key"
});

Response shape

Field	Type	Description
`title`	string \| null	Opportunity title
`solicitation_number`	string \| null	Unique solicitation identifier
`department`	string \| null	Procuring department/agency
`sub_tier`	string \| null	Sub-tier agency code
`office`	string \| null	Procuring office name
`posted_date`	string \| null	Date opportunity was posted
`response_deadline`	string \| null	Proposal response deadline
`type`	string \| null	Procurement type
`set_aside`	string \| null	Small business set-aside type if applicable
`naics_code`	string \| null	Primary NAICS code
`classification_code`	string \| null	Classification code
`active`	string \| null	Active status indicator
`ui_link`	string \| null	URL to opportunity details on SAM.gov
`description`	string \| null	Full opportunity description
`point_of_contact`	array	List of points of contact for the opportunity
`resource_links`	array	URLs to opportunity documents and resources
`archive_type`	string \| null	Archive type if applicable
`archive_date`	string \| null	Archive date if applicable
`organization_type`	string \| null	Type of procuring organization

Full JSON Schema

{
  "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 if applicable"
    },
    "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"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full opportunity description"
    },
    "point_of_contact": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact person full name"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact person title"
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact email address"
          },
          "phone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact phone number"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact type designation"
          }
        }
      },
      "description": "List of points of contact for the opportunity"
    },
    "resource_links": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs to opportunity documents and resources"
    },
    "archive_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Archive type if applicable"
    },
    "archive_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Archive date if applicable"
    },
    "organization_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of procuring organization"
    }
  }
}

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_get_opportunity