search_school_units_by_name

Find Swedish schools by name or partial name patterns to identify specific educational institutions and school groups using official Skolverket data.

Instructions

Sök skolenheter efter namn.

ANVÄNDNINGSFALL:

Hitta specifik skola
Filtrera efter namnmönster
Identifiera skolgrupper

RETURNERAR: Skolenheter som matchar söktermen (delmatchning).

TIPS: Fungerar med partiella namn.

Input Schema

TableJSON Schema

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

Implementation Reference

src/tools/school-units/search.ts:144-177 (handler)

Main execution logic for the 'search_school_units_by_name' tool. Fetches school units by name using the API client, applies optional limit, formats response as JSON text block.

export async function searchSchoolUnitsByName(params: {
  name: string;
  limit?: number;
}) {
  try {
    const units = await schoolUnitsApi.searchSchoolUnitsByName(params.name);

    // 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({
            searchTerm: params.name,
            totalFound: units.length,
            showing: limitedUnits.length,
            schoolUnits: limitedUnits
          }, null, 2)
        }
      ]
    };
  } catch (error) {
    return {
      content: [
        {
          type: 'text' as const,
          text: `Fel vid sökning av skolenheter efter namn: ${error instanceof Error ? error.message : String(error)}`
        }
      ],
      isError: true
    };
  }

src/tools/school-units/search.ts:24-27 (schema)

Input schema definition using Zod for the searchSchoolUnitsByName tool parameters.

export const searchSchoolUnitsByNameSchema = {
  name: z.string().describe('Namn eller del av namn att söka efter'),
  limit: z.number().optional().default(50).describe('Maximalt antal resultat att returnera')
};

src/http-server.ts:75-75 (registration)
Registration of the tool handler in the tools registry object used by the HTTP server.
```
search_school_units_by_name: searchSchoolUnitsByName,
```

src/http-server.ts:27-27 (registration)

Import statement bringing in the searchSchoolUnitsByName handler function.

import { searchSchoolUnits, getSchoolUnitDetails, getSchoolUnitsByStatus, searchSchoolUnitsByName } from './tools/school-units/search.js';

src/api/school-units-client.ts:86-88 (helper)
API client method that performs the actual search by delegating to the general searchSchoolUnits with name filter.
```
async searchSchoolUnitsByName(name: string): Promise<any[]> {
  return this.searchSchoolUnits({ name });
}
```

Skolverket MCP Server