get_entity_updates

Instructions

Implementation Reference

• src/brreg-mcp-server.ts:115-124 (handler)

  Core implementation of the get_entity_updates tool in BrregApiClient, which constructs the API URL and fetches entity updates from the BRREG endpoint '/enhetsregisteret/api/oppdateringer/enheter'.

  async getEntityUpdates(params: {
    dato?: string;
    oppdateringsid?: string;
    organisasjonsnummer?: string[];
    page?: number;
    size?: number;
    sort?: string;
  } = {}) {
    return this.makeRequest('/enhetsregisteret/api/oppdateringer/enheter', params);
  }

• src/brreg-mcp-server.ts:506-515 (handler)

  MCP server dispatch handler for the get_entity_updates tool call, which invokes the apiClient method with input arguments and returns the result as formatted JSON text content.

  case "get_entity_updates":
    const entityUpdates = await apiClient.getEntityUpdates(request.params.arguments as any);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(entityUpdates, null, 2),
        },
      ],
    };

• src/brreg-mcp-server.ts:318-332 (registration)

  Registration of the get_entity_updates tool in the MCP server's listTools response, specifying name, description, and input schema.

  {
    name: "get_entity_updates",
    description: "Get updates on entities for maintaining a local copy of the registry",
    inputSchema: {
      type: "object",
      properties: {
        dato: { type: "string", description: "Show updates from this timestamp (ISO-8601)" },
        oppdateringsid: { type: "string", description: "Show updates from this update ID" },
        organisasjonsnummer: { type: "array", items: { type: "string" }, description: "Filter by organization numbers" },
        page: { type: "number", description: "Page number" },
        size: { type: "number", description: "Page size (default 20, max 10000)" },
        sort: { type: "string", description: "Sort by ID (ASC/DESC)" }
      }
    }
  },

• src/brreg-mcp-server.ts:322-331 (schema)

  Input schema definition for the get_entity_updates tool, validating parameters passed to the handler.

    type: "object",
    properties: {
      dato: { type: "string", description: "Show updates from this timestamp (ISO-8601)" },
      oppdateringsid: { type: "string", description: "Show updates from this update ID" },
      organisasjonsnummer: { type: "array", items: { type: "string" }, description: "Filter by organization numbers" },
      page: { type: "number", description: "Page number" },
      size: { type: "number", description: "Page size (default 20, max 10000)" },
      sort: { type: "string", description: "Sort by ID (ASC/DESC)" }
    }
  }

• src/brreg-mcp-server.ts:48-77 (helper)

  Helper method used by getEntityUpdates to construct the query URL, make the fetch request to BRREG API, handle errors, and parse JSON response.

  private async makeRequest(endpoint: string, params?: Record<string, any>): Promise<any> {
    const url = new URL(`${BASE_URL}${endpoint}`);
    
    if (params) {
      Object.entries(params).forEach(([key, value]) => {
        if (value !== undefined && value !== null) {
          if (Array.isArray(value)) {
            url.searchParams.set(key, value.join(','));
          } else {
            url.searchParams.set(key, String(value));
          }
        }
      });
    }
  
    const response = await fetch(url.toString(), {
      headers: {
        'Accept': 'application/json',
      },
    });
  
    if (!response.ok) {
      if (response.status === 404) {
        throw new McpError(ErrorCode.InvalidRequest, `Resource not found: ${endpoint}`);
      }
      throw new McpError(ErrorCode.InternalError, `API request failed: ${response.status} ${response.statusText}`);
    }
  
    return response.json();
  }