alsos_get_entity

Pack: al-sos-business · 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/alsos_get_entity for the schema, then POST the same URL with its arguments for the data.

One Alabama business entity by its entity number: current name, entity type, status and the date of its dissolution or withdrawal, domestic or foreign, place and date of formation, date qualified in Alabama, principal address, nature of business, authorized capital, and the registered agent when it is a business. Alabama Secretary of State, Business Entity Records, read live. e.g. {entity_number:“000-027-643”}. Returns {found, entity, data_as_of, source}; found:false with reason no_such_entity when the number is not on the register. Individuals the register lists (incorporators, members, partners) are counted and never named.

Parameters

NameTypeRequiredDescription
entity_numberstringyesAlabama entity number, as the register shows it (“000-027-643”) or without dashes or leading zeros (“27643”).

Example call

Arguments

{
  "entity_number": "000-027-643"
}

curl

curl -X POST https://gateway.pipeworx.io/al-sos-business/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"alsos_get_entity","arguments":{"entity_number":"000-027-643"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('alsos_get_entity', {
  "entity_number": "000-027-643"
});

Response shape

FieldTypeDescription
foundboolean
entityobject
individuals_not_servednull
sourcestring
data_as_ofstring
data_as_of_basisstring
Full JSON Schema
{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "entity": {
      "type": "object",
      "properties": {
        "entity_number": {
          "type": "string"
        },
        "entity_id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "legal_name_in_place_of_origin": {
          "type": "null"
        },
        "entity_type": {
          "type": "string"
        },
        "domestic_or_foreign": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "status_normalized": {
          "type": "string"
        },
        "place_of_formation": {
          "type": "string"
        },
        "place_of_formation_kind": {
          "type": "string"
        },
        "formation_date": {
          "type": "string"
        },
        "qualify_date": {
          "type": "string"
        },
        "doing_business_in_alabama_since": {
          "type": "string"
        },
        "principal_address": {
          "type": "object",
          "properties": {
            "street": {
              "type": "string"
            },
            "city": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "zip": {
              "type": "string"
            },
            "text": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "principal_mailing_address": {
          "type": "object",
          "properties": {
            "street": {
              "type": "string"
            },
            "city": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "zip": {
              "type": "string"
            },
            "text": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "nature_of_business": {
          "type": "null"
        },
        "capital_authorized": {
          "type": "null"
        },
        "capital_paid_in": {
          "type": "null"
        },
        "registered_agent": {
          "type": "string"
        },
        "registered_office_address": {
          "type": "object",
          "properties": {
            "street": {
              "type": "string"
            },
            "city": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "zip": {
              "type": "string"
            },
            "text": {
              "type": "string"
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "individuals_not_served": {
      "type": "null"
    },
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "data_as_of_basis": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

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"
    }
  }
}
Connect to just the al-sos-business pack
{
  "mcpServers": {
    "al-sos-business": {
      "url": "https://gateway.pipeworx.io/al-sos-business/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 17, 2026