`sam_entity_search`

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

Search registered federal contractors by business name or UEI. Returns UEI, CAGE code, address, NAICS codes, small business status, and certifications.

Parameters

Name	Type	Required	Description
`business_name`	string	yes	Legal business name to search for
`naics`	string	no	Filter by primary NAICS code (optional)
`state`	string	no	Filter by 2-letter US state code (e.g., “VA”, “CA”)
`small_business`	boolean	no	Filter to only small business entities (optional)
`_apiKey`	string	yes	SAM.gov API key

Example call

Arguments

{
  "business_name": "Acme Tech Solutions",
  "state": "VA",
  "_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_entity_search","arguments":{"business_name":"Acme Tech Solutions","state":"VA","_apiKey":"your-samgov-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('sam_entity_search', {
  "business_name": "Acme Tech Solutions",
  "state": "VA",
  "_apiKey": "your-samgov-api-key"
});

More examples

{
  "business_name": "GreenTech Inc",
  "naics": "541511",
  "small_business": true,
  "_apiKey": "your-samgov-api-key"
}

Response shape

Always returns: total_records, entities

Field	Type	Description
`total_records`	number	Total number of matching entities in SAM
`entities`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_records": {
      "type": "number",
      "description": "Total number of matching entities in SAM"
    },
    "entities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uei": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unique Entity Identifier"
          },
          "cage_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "CAGE Code identifier"
          },
          "legal_business_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Legal business name"
          },
          "dba_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Doing Business As name"
          },
          "registration_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "SAM registration status"
          },
          "registration_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date of initial SAM registration"
          },
          "expiration_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "SAM registration expiration date"
          },
          "address": {
            "type": "object",
            "properties": {
              "line1": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Address line 1"
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "City"
              },
              "state": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "State or province code"
              },
              "zip": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Zip/postal code"
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Country code"
              }
            },
            "description": "Physical business address"
          },
          "primary_naics": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary NAICS code"
          },
          "business_types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of business type classifications"
          },
          "sba_certifications": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "SBA business type certifications held"
          },
          "entity_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Entity website URL"
          }
        }
      }
    }
  },
  "required": [
    "total_records",
    "entities"
  ]
}

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_entity_search