get_school_units_by_status

Filter Swedish school units by operational status to find active, discontinued, or dormant educational institutions for analysis and reporting.

Instructions

Filtrera skolenheter efter status.

ANVÄNDNINGSFALL:

Hitta aktiva skolor
Lista nedlagda skolor
Spåra vilande enheter
Statistik och analys

RETURNERAR: Skolenheter med angiven status.

STATUS: AKTIV, UPPHORT (nedlagd), VILANDE.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`status`	Yes
`limit`	No

Implementation Reference

src/tools/school-units/search.ts:108-142 (handler)

The main tool handler function that fetches school units by status from the API client, applies optional limit, formats JSON response with metadata, and handles errors.

export async function getSchoolUnitsByStatus(params: {
  status: 'AKTIV' | 'UPPHORT' | 'VILANDE';
  limit?: number;
}) {
  try {
    const units = await schoolUnitsApi.getSchoolUnitsByStatus(params.status);

    // Begränsa antal resultat
    const limitedUnits = params.limit ? units.slice(0, params.limit) : units.slice(0, 50);

    return {
      content: [
        {
          type: 'text' as const,
          text: JSON.stringify({
            status: params.status,
            totalFound: units.length,
            showing: limitedUnits.length,
            schoolUnits: limitedUnits
          }, null, 2)
        }
      ]
    };
  } catch (error) {
    return {
      content: [
        {
          type: 'text' as const,
          text: `Fel vid hämtning av skolenheter efter status: ${error instanceof Error ? error.message : String(error)}`
        }
      ],
      isError: true
    };
  }
}

src/tools/school-units/search.ts:19-22 (schema)

Zod schema for input validation: required status enum and optional limit with default 50.

export const getSchoolUnitsByStatusSchema = {
  status: z.enum(['AKTIV', 'UPPHORT', 'VILANDE']).describe('Status att filtrera på'),
  limit: z.number().optional().default(50).describe('Maximalt antal resultat att returnera')
};

src/http-server.ts:74-74 (registration)
Tool registration in the HTTP server's tools registry, mapping 'get_school_units_by_status' to the handler function.
```
get_school_units_by_status: getSchoolUnitsByStatus,
```

src/api/school-units-client.ts:79-82 (helper)

API client helper method that retrieves school units filtered by status using client-side search.

async getSchoolUnitsByStatus(status: 'AKTIV' | 'UPPHORT' | 'VILANDE' | 'PLANERAD'): Promise<any[]> {
  return this.searchSchoolUnits({ status });
}

Skolverket MCP Server