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
| Name | Type | Required | Description |
|---|---|---|---|
entity_number | string | yes | Alabama 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
| Field | Type | Description |
|---|---|---|
found | boolean | |
entity | object | |
individuals_not_served | null | |
source | string | |
data_as_of | string | |
data_as_of_basis | string |
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.